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.