Previous topic |
Next topic |
Contents |
Contact z/OS |
Library |
PDF
SENDCMD—Send a VTAM operator command to VTAM z/OS Communications Server: SNA Programming SC27-3674-00 |
|
PurposeIt is possible for an application program to send VTAM® operator commands to VTAM and to reply to messages sent to the application program by VTAM. The SENDCMD macroinstruction permits an authorized application program to send the following commands: VARY, DISPLAY, MODIFY, and REPLY. Note: The HALT and START commands cannot be
issued using the SENDCMD macroinstruction. They can be issued only
by the VTAM operator at the
system console.
UsageBefore issuing the SENDCMD macroinstruction the application program must set register 13 to the address of an 18-word save area. Refer to Summary of register usage, for information pertaining to the register contents upon return of control. For information on writing an application program that can issue VTAM operator commands and receive VTAM messages, see Program operator coding requirements. VTAM receives control from the SENDCMD macroinstruction in the addressing mode of the application program that issued the macroinstruction and returns control to the application program in that same mode. Syntax>>-+------+--SENDCMD--RPL--=--rpl_address-----------------------> '-name-' >--+----------------------------+-------------------------------> | (1) | '-,--ACB--=--acb_address-----' >--+---------------------------------+--------------------------> | (1) | '-,--AREA--=--command_address-----' >--+---------------------------+--------------------------------> | (1) | '-,--BRANCH--=--+-NO--+-----' '-YES-' >--+--------------------------------------+---------------------> | (1) | +-,--ECB--=--INTERNAL------------------+ +-,--ECB--=--ecb_address---------------+ | (1) | '-,--EXIT--=--exit_routine_address-----' >--+--------------------------------+---------------------------> | (1) | '-,--OPTCD--=--(--+-ASY-+--)-----' '-SYN-' >--+----------------------------------+------------------------>< | (1) | '-,--RECLEN--=--command_length-----' Notes:
Input parameters
The following RPL operands apply to the SENDCMD
macroinstruction:
Examples
SENDCMD1 sends a message to VTAM, consisting of the area between VARYCMD1 and CMDEND, instructing it to activate logical unit LU1. The status field indicates that a reply is returned to the application program. See Data exchanged between a program operator and VTAM for information pertaining to the header and status field settings. Completion informationA SENDCMD operation is successfully completed when the command is passed to VTAM for subsequent processing. After
the SENDCMD operation is completed, the following RPL fields are set:
Registers 0 and 15 are also set as indicated in Handling errors and special conditions. |
Copyright IBM Corporation 1990, 2014
|