The OSREQ command is a TSO/E command processor. OSREQ can be invoked for any of the following situations:

• At the TSO/E READY prompt when logged on to TSO/E
• Under option 6 "Command" under ISPF/PDF
• On the ISPF command line by prefacing the OSREQ command with the characters "TSO"
• From within a TSO/E CLIST
• From a batch job, by invoking the TSO/E terminal monitor program (TMP) in the batch job

SAMPLIB member CBRSAMIV invokes the OSREQ macro from an MVS batch job, which invokes the TSO/E terminal monitor program (IKJEFT01) that runs in the background. This job allows you to verify the installation of OAM to ensure object storage success.

//CBRSAMIV  JOB CLASS=A,MSGCLASS=A,MSGLEVEL=(1,1)
//*********************************************************************
//*                                                                   *
//*  $SEG(CBRSAMIV) COMP(OSR) PROD(OAM):                              *
//*                                                                   *
//* THIS SAMPLE JOB INVOKES THE OSREQ COMMAND PROCESSOR TO PERFORM    *
//* THE FOLLOWING ACTIONS:                                            *
//*                                                                   *
//* 1. STORE A 1 MB (1048576) OBJECT.                                 *
//*                                                                   *
//* 2. ISSUE AN OSREQ QUERY TO LIST THE OAM DIRECTORY INFORMATION.    *
//*                                                                   *
//* 3. ISSUE A LISTCAT COMMAND TO LIST THE COLLECTION NAME ENTRY      *
//*    FROM THE ICF CATALOG.                                          *
//*                                                                   *
//* 4. ISSUE AN OSREQ CHANGE REQUEST TO CHANGE THE RETENTION PERIOD   *
//*    ASSOCIATED WITH THE OBJECT TO 365 DAYS.                        *
//*                                                                   *
//* 5. ISSUE AN OSREQ QUERY TO LIST THE OAM DIRECTORY INFORMATION.    *
//*                                                                   *
//* 6. ISSUE AN OSREQ RETRIEVE TO RETRIEVE THE PRIMARY COPY OF THE    *
//*    AND CHECK TO SEE IF IT CONTAINS THE PRE-DEFINED PATTERN DATA.  *
//*                                                                   *
//* 7. ISSUE AN OSREQ DELETE REQUEST TO DELETE THE OBJECT.            *
//*                                                                   *
//*                                                                   *
//* PRIOR TO EXECUTING THIS JOB YOU MAY NEED TO MAKE THE FOLLOWING    *
//* MODIFICATIONS:                                                    *
//*                                                                   *
//*  1. CHANGE THE JOB CARD PER YOUR INSTALLATION REQUIREMENTS.       *
//*                                                                   *
//*  2. CHANGE THE COLLECTION NAME, OBJECT NAME AND LENGTH OF         *
//*     OBJECT TO CONFORM TO YOUR INSTALLATION REQUIREMENTS.          *
//*                                                                   *
//*                                                                   *
//*  CHANGE ACTIVITY:                                                 *
//*    $L0=OBJTAPE 120 930525 TUCFJK: INITIAL RELEASE OF THE OAM IVP  *
//*                                   SAMPLE JCL.                     *
//*    $01=OW02037 120 940201 TUCFJK: ADDED DOCUMENTATION NOTE THAT   *
//*                                   JCL MAY NEED MODIFICATION PER   *
//*                                   INSTALLATION REQUIREMENT.       *
//*                                   (PTM # K120990)                 *
//*    $P1=K190248 R19 060815 TUCYHL: CHANGE JOB CARD OAMIVP TO       *
//*                                   CBRSAMIV                        *
//*********************************************************************
//STEP1    EXEC PGM=IKJEFT01,REGION=4096K
//SYSPRINT DD   SYSOUT=*
//SYSTSPRT DD   SYSOUT=*
//SYSTSIN  DD   *
 OSREQ STORE    COLLECT.NAME OBJECT.NAME LENGTH(1048576)
 OSREQ QUERY    COLLECT.NAME OBJECT.NAME
 LISTCAT ENTRIES('COLLECT.NAME') ALL
 OSREQ CHANGE   COLLECT.NAME OBJECT.NAME RP(365)
 OSREQ QUERY    COLLECT.NAME OBJECT.NAME
 OSREQ RETRIEVE COLLECT.NAME OBJECT.NAME COMPARE VIEW(PRIMARY)
 OSREQ DELETE   COLLECT.NAME OBJECT.NAME
/*