Sample jobs are provided for the invocation of the OAM installation verification program using TSO/E and the OAM utility, OAMUTIL, to reformat 3995 optical cartridges or to modify the default storage class and/or the default management class of a collection. CBRSAMIV is the sample job for the OAM Installation Verification Program (OAMIVP).
Installation verification ensures that the proper environment exists for applications to utilize the OSREQ Macro Application Programming Interface (API).
The previous diagram illustrates a number of different ways in
which you may directly or indirectly invoke the OSREQ API:
- A TSO/E command interface (OSREQ TSO/E Command Processor) provides a simple mechanism to invoke individual OSREQ API functions. The usually required OSREQ ACCESS and UNACCESS functions are performed automatically within the OSREQ TSO/E command processor around the individual function to be performed. The OSREQ TSO/E command processor does not provide the full functionality of the OSREQ API, and you cannot store real data using the OSREQ TSO/E command processor STORE function; otherwise dummy data is created for the object. You can use the OSREQ TSO/E command processor as a simple mechanism to perform some other operations on real object data without having to write an application program. You can use the OSREQ TSO/E command processor to compare the primary copy of an object with a backup copy of the object, for example, with the intent of ensuring both copies match to meet audit requirements. The OSREQ TSO/E command processor can be invoked in a native TSO environment at the READY prompt or within a CLIST, from ISPF, or by invoking the TSO/E program IKJEFT01 in the background through a batch job and providing OSREQ TSO/E commands as an input. For the OSREQ TSO/E command processor syntax, see OSREQ TSO/E command syntax.
- The CBRSAMIV sample job is provided to perform OAM installation verification. Within the CBRSAMIV job, the TSO/E program IKJEFT01 is used to provide OSREQ TSO/E commands to store an object and perform several other operations on the object and ultimately deleting the object. This provides a simple mechanism to verify that the OAM installation has been performed successfully and that the OSREQ API invocations are working as expected. The CBRSAMIV sample job is described later in this section.
- The CBROSREQ sample contains an assembler program that is provided as an example to illustrate how to invoke the individual OSREQ API functions. Application developers, however, can also assemble, link-edit, and then by directly calling the sample program, execute the sample program as an interface to the OSREQ API. For the description of the CBROSREQ sample program, see z/OS DFSMS OAM Application Programmer's Reference.
- Application developers can also develop assembler programs that directly invoke the OSREQ API. For the syntax for the OSREQ API, see z/OS DFSMS OAM Application Programmer's Reference.