PUSHPARM

From m204wiki
Jump to navigation Jump to search

The PUSHPARM command saves resetable parameters(user/system/file) and changes the values to the new specified value. New values are simply added to the PUSHPARM command, ie. PUSHPARM MCPU 1000. Only one PUSHPARM may be done per include level. The user specifying the command must have RESET authority to update the specified parameter or the entire command will be rejected.

The POPPARM command restores all resetable parameters previously saved by PUSHPARM or PUSHPARMQ.

PUSHPARMQ is identical to PUSHPARM, but the new results are not displayed(Quiet).

Command syntax

The general form of the commands is:

PUSHPARM [Parameters] POPPARM

Where:

  • Parameters are simply the values one would specify on a RESET command.

Only one PUSHPARM command can be active in a single INCLUDE level. When the INCLUDE level is closed, the parameter settings saved by the active PUSHPARM command are automatically restored. They can also be explcitly restored with a POPPARM command at the same INCLUDE level. A typical use of the PUSHPARM command would be to set a specific parameter for a specific procedure in a subsystem so that the standard parameter settings are restored when the request had completed. For example:

PUSHPARM LAUDIT 0 begin ... procedure code end

When the procedure containing the PUSHPARM command is closed, whether or not the code inside the Begin/End block ran successfully or got a request canceling error or even a compile error, the parameter setting is restored to what it was before the PUSHPARM command. Note that adding a POPPARM command after the End, while harmless, doesn't help, as the end of procedure restores the saved PUSHPARM setting anyway and the explicit POPPARM would never be seen in the case of errors.

Note: PUSHPARM and POPPARM support relative value setting (see PUSHUTABLE).