IMSCMD input

IMSCMD function syntax

     IMSCMD(COMMAND(command)
            SYSTEMS(systems-list)
             )

Parameter reference

COMMAND

Use this required parameter to specify a single IMS Type-1 AOI command to be issued. Specify the IMS commands as you would normally; starting with a slash (/) and following the same syntax as the command follows when it is issued manually. For example:

IMSCMD(COMMAND(/STA DB F1O1P11 H1V4S12))

Note: The command value can be a maximum of 80 characters.

SYSTEMS

Use this optional parameter to specify one or more active IMS systems to which the command is issued. If you omit this parameter, the command is issued to all of the active IMS systems in the IMS Tools Online System Interface XCF group. If a system that is specified in the list is not active, the fact that the system was inactive is noted in the output, but the command is still issued for any active systems in the Tools Online System Interface XCF group.

When you use the GLOBAL parameter on IMS commands, the SYSTEMS parameter is not allowed. If you specify both the GLOBAL and SYSTEMS parameters, an error message is displayed and the IMS command is not performed. The GLOBAL parameter requires internal resource lock manager (IRLM) in order to run the commands on all of the sharing online subsystems.

Notes on using the IMSCMD function

The IMSCMD(COMMAND(command)) function accepts a maximum of 80 characters for the command value. If greater than 80 characters are specified, then the job terminates and the message BPE0003E is displayed.

As a workaround, you can issue multiple IMSCMDs in one job step. For example:

//IMSREIN DD*
IMSCMD(COMMAND(/STA DB H1V4P1 H1V4S1 H1V4S2 H1V4P11 H1V4P12 H1V4P13))   
IMSCMD(COMMAND(/STA DB H1V4S11 F1O1P11 H1V4S12))