This macro provides the same function as the CMDS operator command. It can be used to obtain information about MVS™ commands which are attached or waiting to be attached in the *MASTER* or CONSOLE address spaces.
It can also be used to remove commands which are waiting. It cannot be used to cancel commands which are already executing.
The requirements for the caller are:
Environmental factor | Requirement |
---|---|
Minimum authorization: | Supervisor state. System PSW key. |
Dispatchable unit mode: | Task |
Cross memory mode: | PASN = HASN = SASN |
AMODE: | 31-bit addressing mode. |
ASC mode: | Primary or access register (AR) |
Interrupt status: | Enabled for I/O and external interrupts |
Locks: | No Locks may be held. |
Control parameters: | Must be in the primary address space. |
The calling program may include mapping macro IEEZB889 which can be used to map the information which is returned in the buffer specified as BUFFER.
The caller cannot be protected by an FRR.
Before issuing the IEECMDS macro, the caller does not have to place any information into any register unless using it in register notation for a particular parameter, or using it as a base register.
Some callers depend on register contents remaining the same before and after issuing a service. If the system changes the contents of registers on which the caller depends, the caller must save them before issuing the service, and restore them after the system returns control.
None.
The IEECMDS macro is written as follows:
Syntax | Description |
---|---|
name | name: Symbol. Begin name in column 1. |
␢ | One or more blanks must precede IEECMDS. |
IEECMDS | |
␢ | One or more blanks must follow IEECMDS. |
REQUEST=COUNT | Default: REQUEST=COUNT |
,REQUEST=INFO | |
,REQUEST=REMOVE | |
,BUFFER=buffer | Required with REQUEST=INFO or REQUEST=REMOVE |
buffer: RS-type address or address in register (2) - (12). | |
,BUFSIZE=bufsize | Required with REQUEST=INFO or REQUEST=REMOVE |
bufsize: RS-type address or address in register (2) - (12). | |
,CLASS=class | class: RS-type address or address in register (2) - (12). |
,CLASS=ANY_CLASS | Default: CLASS=ANY_CLASS |
,CMD=cmd | cmd: RS-type address or address in register (2) - (12) |
,CMD=ANY_CMD | Default:CMD=ANY_CMD |
,ID =id | id: RS-type address or address in register (2) - (12) |
,ID=ANY_ID | Default:: ID=ANY_ID |
,JOB=job | job: RS-type address or address in register (2) - (12) |
,JOB=ANY_JOB | Default:: CMD=ANY_JOB |
,COUNT=count | count: RS-type address or address in register (2) - (12) |
,RETCODE=retcode | retcode: RS-type address or register (2) - (12). |
,RSNCODE=rsncode | rsncode: RS-type address or register (2) - (12). |
,PLISTVER=IMPLIED_VERSION | Default: PLISTVER=IMPLIED_VERSION |
,PLISTVER=MAX | |
,PLISTVER=1 | |
,MF=S | Default: MF=S |
,MF=(L,list addr) | list addr: RS-type address or register (1) - (12). |
,MF=(L,list addr,attr) | |
,MF=(L,list addr,0D) | |
,MF=(E,list addr) | |
,MF=(E,list addr,COMPLETE) | |
,MF=(E,list addrNOCHECK) | |
,MF=(M,list addr) | |
,MF=(M,list addr,COMPLETE) | |
,MF=(M,list addrNOCHECK) | |
The parameters are explained as follows:
Message IEE065I is issued for each removed command. It is directed to the console that issued the removed command.
To code:Specify the RS-type address of address in register (2)-(12), of a character field.
To code:Specify the RS-type address of address in register (2)-(12), of a fullword field.
The default is ANY_CLASS.
For detailed information about command classes, see the description of command flooding in z/OS MVS System Commands.
To code:Specify the RS-type address or address in register (2)-(12) of a 4–character field.
The command name must be specified as the full name, not an abbreviation. This is to conform with the command name returned during the previous execution of the macro with REQUEST=INFO. The default is ANY_CMD.
To code:Specify the RS-type address or address in register (2)-(12) of an 8–character field.
To code:Specify the RS-type address or address in register (2)-(12) of an 4–character field.
To code:Specify the RS-type address or address in register (2)-(12) of an 8–character field.
To code:Specify the RS-type address or address in register (2)-(12) of an pointer field.
To code: Specify the RS-type address of a fullword field, or register (2)-(12).
To code: Specify the RS-type address of a fullword field, or register (2)-(12).
If you can tolerate the size change, IBM® recommends that you always specify PLISTVER=MAX on the list form of the macro. Specifying MAX ensures that the list-form parameter list is always long enough to hold all the parameters you might specify on the execute form, when both are assembled with the same level of the system. In this way, MAX ensures that the parameter list does not overwrite nearby storage.
Use MF=S to specify the standard form of the macro, which builds an inline parameter list and generates the macro invocation to transfer control to the service. MF=S is the default.
Use MF=L to specify the list form of the macro. Use the list form together with the execute form of the macro for applications that require reentrant code. The list form defines an area of storage that the execute form uses to store the parameters. Only the PLISTVER parameter may be coded with the list form of the macro.
Use MF=E to specify the execute form of the macro. Use the execute form together with the list form of the macro for applications that require reentrant code. The execute form of the macro stores the parameters into the storage area defined by the list form, and generates the macro invocation to transfer control to the service.
Use MF=M together with the list and execute forms of the macro for service routines that need to provide different options according to user-provided input. Use the list form to define a storage area; use the modify form to set the appropriate options; then use the execute form to call the service.
None.
Macro IEECMDS provides equate symbols for the return and reason codes.
The following table identifies the hexadecimal return and reason codes:
Hexadecimal Return Code | Hexadecimal Reason Code | Equate Symbol Meaning and Action |
---|---|---|
00 | — | Equate Symbol: CMDS_RC_OK Meaning: Matching commands have been found. In the case of a REQUEST type of INFO or REMOVE, the output buffer was sufficient to hold all of the information for the commands meeting the search criteria. Action: None |
04 | — | Equate Symbol: CMDS_RC_NOCMDS Meaning: No commands meet the specified filters. Action: None |
08 | — | Equate Symbol: CMDS_RC_NOSTOR Meaning: Insufficient return buffer storage to complete the query operation. Action: Refer to the action provided with the specific reason code. |
08 | 04 | Equate Symbol: CMDS_RS_SOMECMDS Meaning: The output buffer is too small to contain all requested information, but does contain the information for one or more commands. If REQUEST=REMOVE, the system has removed only the commands for which information is returned. Action: The count of matching commands has been returned. Adjust the buffer size so that it is at least as large as the count multiplied by the output size for each entry, plus the length of the header, and issue the macro again. The constant CMDS_HEADER_LENGTH represents the amount of storage required for the buffer header. The constant CMDS_ENTRY_LENGTH represents the amount of storage required per command. These constants are declared in mapping macro IEEZB889. |
08 | 08 | Equate Symbol: CMDS_RS_NOCMDS Meaning: The output buffer is too small to contain the information for even one command. If REQUEST=REMOVE, the system has not removed any commands. Action: The count of matching commands has been returned. Adjust the buffer size so that it is at least as large as the count multiplied by the output size for each entry, plus the length of the header, and issue the macro again. The constant CMDS_HEADER_LENGTH represents the amount of storage required for the buffer header. The constant CMDS_ENTRY_LENGTH represents the amount of storage required per command. These constants are declared in mapping macro IEEZB889. |
10 | — | Equate Symbol: CMDS_RC_INVPL Meaning: Invalid parameter list. Action: Refer to the action provided with the specific reason code |
10 | 04 | Equate Symbol: CMDS_RS_INVACRN Meaning: The acronym in the parameter list was invalid. Action: Correct the acronym in the parameter list and issue IEECMDS again. |
10 | 08 | Equate Symbol: CMDS_RS_INVADDR Meaning: An output message is invalid. An ABEND occurred while trying to access storage at an address specified in the parameter list, possibly because that storage is not accessible by the caller, or the storage does not exist. Action: Correct the invalid address in the parameter list and issue IEECMDS again. |
10 | 0C | Equate Symbol: CMDS_RS_INVBUFFER Meaning: The address or length of the buffer in the parameter list was invalid. Action: Correct the values of BUFFER or BUFSIZE or both in the parameter list and issue IEECMDS again. |
10 | 10 | Equate Symbol: CMDS_RS_INVLGTH Meaning: The length of the parameter list is invalid. Action: Correct the length in the parameter list and issue IEECMDS again. |
10 | 14 | Equate Symbol: CMDS_RS_INVVERS Meaning: The version specified in the parameter list is invalid. Action: Correct the version in the parameter list and issue IEECMDS again. |
10 | 18 | Equate Symbol: CMDS_RS_INVFUNC Meaning: The REQUEST type specified in the parameter list is not a valid REQUEST type. Action: Correct the REQUEST type in the parameter list and issue IEECMDS again. |
10 | 1C | Equate Symbol: CMDS_RS_INVCLASS Meaning: The CLASS specified in the parameter list is not a valid CLASS name. Action: Correct the CLASS in the parameter list and issue IEECMDS again. |
10 | 20 | Equate Symbol: CMDS_RS_INVID Meaning: The ID specified in the parameter list is not a valid value. The ID value must be a decimal number in EBCDIC printable) characters. Action: Correct the ID in the parameter list and issue IEECMDS again. |
40 | — | Equate Symbol: CMDS_RS_SYSERR Meaning: System Error. This return code is for IBM diagnostic purposes only. Action: Record the return and reason codes and supply it to the appropriate IBM support personnel. |
40 | 04 | Equate Symbol: CMDS_RS_SYSABEND Meaning: An ABEND occurred during processing. This reason code is for IBM diagnostic purposes only. Action: Record the return and reason codes and supply it to the appropriate IBM support personnel. |
40 | 08 | Equate Symbol: CMDS_RS_SYSERR Meaning: An error occurred during processing. This reason code is for IBM diagnostic purposes only. Action: Record the return and reason codes and supply it to the appropriate IBM support personnel. |