Operator command reference

Advanced Archive for DFSMShsm provides several operator commands for interacting with the AXQTINIT started task for automatic Restore operations.

ACTIVATE

Activates the Catalog Address Space hook, the LOCATE SVC intercepts, or both.

Syntax	`ACTIVATE ALLWARN\|ALLDYN\|LOCWARN\|LOCDYN\|CAS`
Operands	`ALLWARN` Activate the Catalog Address Space hook and the SVC 26 LOCATE hook, in warning mode. `ALLDYN` Activate the Catalog Address Space hook and the SVC 26 LOCATE hook, in dynamic restore mode. `LOCWARN` Activate only the SVC 26 LOCATE hook, in warning mode. `LOCDYN` Activate only the SVC 26 LOCATE hook, in dynamic restore mode. `CAS` Activate only the Catalog Address Space hook.
Note	It is recommended that the Catalog Address Space hook and the SVC 26 LOCATE hook both be in the same state. The hooks should both be activated or both be deactivated.

DEACTIVATE

Deactivates the Catalog Address Space hook, the LOCATE SVC intercepts, or both.

Syntax	`DEACTIVATE ALL\|LOCATE\|CAS`
Operands	`ALL` Deactivate the Catalog Address Space hook and the SVC 26 LOCATE hook. `LOCATE` Deactivate only the SVC 26 LOCATE hook. `CAS` Deactivate only the Catalog Address Space hook.
Note	It is recommended that the Catalog Address Space hook and the SVC 26 LOCATE hook both be in the same state. The hooks should both be activated or both be deactivated.

DIAG

Displays diagnostic and statistical information.

Syntax	`DIAG`
Operands	None
Note	Use only under the direction of IBM Software Support.

DISABLE

Disables subsystem activity or tracing. Disabling a subsystem is somewhat different from deactivating intercepts; DISABLE keeps the LOCATE intercept in its current state, but causes it to internally skip processing, which has the effect of disabling started task processing.

Syntax	`DISABLE SUBSYSTEM\|TRACING`
Operands	`SUBSYSTEM` Keeps hooks in their current state but causes the LOCATE intercept to skip its processing. `TRACING` Disables product tracing.
Note	Use this command only under the direction of IBM Software Support.

DISPLAY

Displays various types of product information.

Syntax	`DISPLAY ALL\|MODADDR\|MODHDR\|SUBSYSTEM\|TRACING`
Operands	`ALL` Display the status of the subsystem and the status of product tracing. `MODADDR modname` Display the address of module `modname`. `MODHDR modname\|ALL` Display header information for module `modname` or for all modules. `SUBSYSTEM` Display the status of the subsystem. `TRACING` Display the status of product tracing.
Note	Use the `MODADDR`, `MODHDR`, and `TRACING` operands only under the direction of IBM Software Support.

ENABLE

Enables previously disabled subsystem activity or enables product tracing.

Syntax	`ENABLE SUBSYSTEM\|TRACING`
Operands	`SUBSYSTEM` Enable product intercept processing. `TRACING` Enable product tracing.
Note	Use this command only under the direction of IBM Software Support.

REFRESH

Refreshes the parameters that are passed to the automatic Restore program, as specified in the AXQPRLIB parameter data set, as well as in certain critical hook modules. The REFRESH command refreshes the same parameters as those that are passed to the batch Restore program.

The AXQCASHK and AXQCASHK2 modules manage the Catalog Address Space hooks, the AXQS1INT module manages the LOCATE SVC hook, and the AXQSVC26 module is the actual LOCATE SVC replacement code.

It is unnecessary to deactivate the hooks before refreshing the parameters or modules. The old modules are still used for any active processing, and new modules and parameters are used for the next invocation of a hook.

Syntax	`REFRESH ALL\|MODS\|PARMS`
Operands	`ALL` Refresh the parameter library values and the hook modules. `MODS` Refresh only the hook modules. `PARMS` Refresh only the parameter library values.
Note	Under normal circumstances, only the parameter library values should need to be refreshed while the started task is running. Use the `MODS` operand only under the direction of IBM Software Support.

SHUTDOWN

Shuts down the AXQTINIT started task and (optionally) produces an SVC DUMP of the address space. Alternatively, you can use the z/OS STOP command to request that the started task be shut down.

Syntax	`SHUTDOWN [none]\|DUMP`
Operands	[none] Perform an orderly shutdown. `DUMP` Create an SVC `DUMP` and then perform an orderly shutdown.
Note	Use the `DUMP` operand only under the direction of IBM Software Support.

STATUS

Displays status information about the Catalog Address Space hook, the SVC 26 LOCATE hook, or both.

Syntax	`STATUS ALL\|LOCATE\|CAS`
Operands	`ALL` Display the status of the Catalog Address Space hook and the SVC 26 LOCATE hook. `LOCATE` Display the status of the SVC 26 LOCATE hook only. `CAS` Display the status of the Catalog Address Space hook only.

STOP

Shuts down the product and (optionally) produces an SVC DUMP of the address space.

Syntax	`STOP [none]\|DUMP`
Operands	[none] Perform an orderly shutdown. `DUMP` Create an SVC `DUMP` and then perform an orderly shutdown.
Note	Use the `DUMP` operand only under the direction of IBM Software Support.