Installation Verification

This chapter describes how to use COBOL to verify that OpenFrame Batch (hereafter "Batch") has been successfully installed.

1. Overview

A batch system runs jobs written in JCL and provides a TJES environment that execute batch jobs in the same way as on a mainframe.

2. Verification Procedure

Start the Server

Use the tmadmin tool to verify that the server for executing batch jobs is running.

$ tmadmin
--- Welcome to Tmax Admin (Type "quit" to leave) ---

$$1 NODE1 (tmadm): si
------------------------------------------------------------------------
  clh   svrname    (svri)   status     count   qcount   qpcount  emcount
------------------------------------------------------------------------
    0   TPFMAGENT  (   4)      RDY         0        0         0        0
    0   ofrsasvr   (   5)      RDY         0        0         0        0
    0   ofrlhsvr   (   6)      RDY         0        0         0        0
    0   ofrdmsvr   (   7)      RDY         0        0         0        0
    0   ofrdsedt   (   8)      RDY         0        0         0        0
    0   ofrcmsvr   (   9)      RDY         0        0         0        0
    0   ofruisvr   (  10)      RDY         0        0         0        0
    0   ofrsmlog   (  11)      RDY         0        0         0        0
    0   obmjmsvr   (  12)      RDY         0        0         0        0
    0   obmjschd   (  13)      RDY         1        0         0        0
    0   obmjinit   (  14)      RDY         2        0         0        0
    0   obmjhist   (  15)      RDY         0        0         0        0
    0   obmjspbk   (  16)      RDY         0        0         0        0
    0   ofrpmsvr   (  17)      RDY         0        0         0        0
    0   obmtsmgr   (  18)      RDY         0        0         0        0
    0   obmjtimr   (  19)      RDY         0        0         0        0

Write COBOL Program

Write a COBOL program that outputs a string. After writing the program, compile the code using NetCOBOL and register it. An example is as follows:

       IDENTIFICATION                     DIVISION.
       PROGRAM-ID.                        COBOLA.
       AUTHOR.                            COBOLA.
       ENVIRONMENT                        DIVISION.
       DATA                               DIVISION.
       WORKING-STORAGE                    SECTION.
       PROCEDURE                         DIVISION.

       DISPLAY '  ***   BATCH JOB TEST   *** '.

Write JCL

Write a JCL that calls COBOLA (COBOL PROGRAM). An example based on MVS syntax is as follows:
```
//TEST JOB
//JOBLIB DD DSN=PROD.BATCHLIB,DISP=SHR
//STEP01 EXEC PGM=COBOLA
//SYSOUT DD SYSOUT=*
```

Submit Job

Submit a job using the tjesmgr RUN option. Once submitted, the job is loaded into JOBQ in the START state and can be verified using the PS command.

tjesmgr RUN TEST NODE=NODE1

>
Command : [RUN /home/binstall64/OpenFrame/volume_DEFVOL/SYS1.JCLLIB/TEST NODE=NODE1]
Node name : NODE1
(JOB00405) /home/binstall64/OpenFrame/volume_DEFVOL/SYS1.JCLLIB/TEST is submitted as TEST(JOB00405).

Verify Normal Operation

Use the options of the tjesmgr tool to verify the job’s status and conform its normal operation.

Use the tjesmgr PSJ [JOBID] command to verify that the job has completed with status Done (R00000).

JOB  ID    : JOB00405      NODE NAME  : NODE1
JOBG NAME  : SYSGRP        JOB  NAME  : TEST
JOB  CLASS : A , JOB STATUS : Done(R00000) , JOB PRTY : 0 , JCLRUNNER INDEX : 0
JOB  USER  : ROOT
JCL  PATH  : /home/binstall64/OpenFrame/volume_DEFVOL/SYS1.JCLLIB/TEST
TIME STAMP : READY : 20250701/18:18:32, START : 20250701/18:20:05
                                        END   : 20250701/18:20:07
RES  USAGE : PROCESS - 2s CPU - (0s,0%)  MEM - 0Byte

STEP LIST  :
-
[        ] START : 20250701/18:20:06, RC=R0000, CPU - 0s (0s)
-

SPOOL LIST :
-
NO  STEP              DDNAME       SIZE  DSNAME
-
0   -                 INPJCL          88 INPJCL
1   -                 SYSMSG          1K SYSMSG
2   -                 CATPROC         88 CATPROC
3   -                 CONVJCL        723 CONVJCL
4   -                 CONMSG         665 CONMSG
5   -                 JESMSG         582 JESMSG
6   -                 JESJCL         1K  JESJCL
7   STEP01            SYSOUT         1K  oframe3.TEST.JOB00405.D000001
-

OUTPUT PROCESSING STATUS : all outputs were processed

Use the tjesmgr PODD [JOBID] [DI=<dd-index> | DN=<dd-name>] command to verify that the DISPLAY statement output from the COBOL program has been executed correctly.
```
   ***   BATCH JOB TEST   ***
```