Invoking the OSREQ macro through the OSREQ TSO/E command processor

The OSREQ command is a TSO/E command processor that closely resembles the OSREQ macro, a programming interface, provided by OAM. The OSREQ macro is used for the storage, retrieval, query, deletion of objects, and comparing primary data to backup data. The OSREQ TSO/E command is used to exercise the OSREQ macro interface and OAM without having to explicitly use the OSREQ ACCESS and UNACCESS macros to connect and disconnect the macro to OAM.

Each time the OSREQ command is issued, the OSREQ TSO/E command processor performs the OSREQ ACCESS macro between itself and OAM. If the OSREQ ACCESS macro is successful, the OSREQ command processor continues and performs the requested function. After the function is performed, the OSREQ command processor disconnects itself from OAM through an OSREQ UNACCESS macro command.

The following functions can be performed against objects: store, retrieve, query, delete, compare, and change the management class, storage class, and retention period.

Note: Check with your application provider for any corequisite support that may be required in order to store objects larger than 50MB.

Note: For OSREQ generic QUERY, the percent ('%') and underscore ('_') wildcard characters introduced in z/OS Version 1 Release 11 cannot be used with the TSO/E command processor. Only the asterisk ('*') wildcard character is valid for use with the TSO/E OSREQ command processor. Refer to the z/OS DFSMS OAM Application Programmer's Reference z/OS DFSMS OAM Application Programmer's Reference for detailed information on OSREQ QUERY.

Recommendation: This command processor verifies object support after product installation. You might also use it as a tool to assist in recreating a customer problem in a controlled environment. You cannot use this tool to store actual data, because the STORE function creates "dummy" data.

For more information on using the OSREQ macro, see the z/OS DFSMS OAM Application Programmer's Reference.