Previous Topic: ADDRESS TSO Return CodesNext Topic: ADDRESS USS USSCMD—Issue UNIX Commands


ADDRESS USS Commands

ADDRESS USS is an OPS/REXX host command environment that allows you to issue UNIX System Services commands and, optionally, retrieve command responses. The commands are sent to the USS class of OSF servers for execution in a UNIX System Services environment, and the responses are returned to the issuing OPS/REXX program in the form of REXX stem variables.

With the exception of USSCMD, the ADDRESS USS commands result in calls to the CCS for z/OS Application Programming Interface (API) from the USS server. These API calls augment the standard UNIX commands provided with CCS for z/OS that are executable using the USSCMD command.

The API commands bring additional functionality to the standard CCS for z/OS commands because they provide the ability to specify values for the optional fields of the message records (for example, message severity that can be used by Event Manger, or CA OPS/MVS rules for automation applications). Some API functions, such as DOM, have no equivalent UNIX command in CCS for z/OS.

For example, when executed as a USSCMD, the CAWTOR waits indefinitely for a response. The WTOR API call honors the wait time specified by the caller and removes the WTOR if no response is provided in the waiting period. This prevents USS server cancellation if the transaction elapsed time limit for the server is exceeded.