TULIB - Program Catalog Maintenance Utility

The purpose of batch utility program TULIB is to enable mass sequential invocation of ULIB commands. It enables three of the functions of the online utility program ULIB to be performed in a batch environment:

  • CAT

  • DEL

  • REF

Note that the remaining functions of ULIB are not supported by TULIB. Sample execution job control is given in the distribution Com-plete source library in member JCLTULIB.

Note:
To use this utility, Com-plete must be active with sysparm SUBSYS-ACTIVATE=ACCESS and defined in ACSTAB.


How to Use TULIB

The job control required to execute program TULIB is illustrated below:

//TULIB    JOB  job-card information 
//TULIB    EXEC PGM=TULIB 
//STEPLIB  DD   DSN=COM.USER.LOAD,DISP=SHR 
//         DD   DSN=COM.LOAD,DISP=SHR
//         DD   DSN=ADABAS.LOAD,DISP=SHR
//SYSPRINT DD   SYSOUT=A 
//SYSIN    DD   * 
DEL,PGMA 
CAT,PGMA,RG=24K,TG=THREADSX,PG=TASKY 
/* 
* $$ JOB JNM=TULIB,DISP=D,CLASS=? ......  POWER JOB CARD INFORMATION
* $$ LST DISP=D,CLASS=A
// JOB   TULIB                    ......  JOB CARD INFORMATION
/*
/* ==================================================
/*
/* Com-plete MUST BE ACTIVE WITH ACCESS SUPPORT
/*
/* ==================================================
/*
// LIBDEF    PHASE,SEARCH=(SAGLIB.COMUSER,     /* load ACSTAB */       *
             SAGLIB.COMvrs,                            <---- Note 1    *
             SAGLIB.CADAvrs),temp                      <---- Note 1
// EXEC      TULIB,SIZE=AUTO
CAT,DEMO,RG=8K
DEL,RMPGMA
/*
/&
* $$ EOJ

vrs in these cases relates to the Version, Release and SM level of the Com-plete being installed.

Descriptions of the DD/DLBL statements used in the preceding job control are given on the next page.

Control Card Input

The control statements used as input by the SYSIN/SYSIPT file define which function to perform and the programs on which to perform that function.

The format of the control cards used as input to TULIB is exactly the same as for the ULIB, CAT, and DEL commands:

Column 1 CAT, DEL or REF
Column 5 Name of program followed by the desired information as described in the Com-plete Utilities documentation

Note that control statements may not be continued, and that there must be only one function specified per control statement. An unlimited number of control statements may be used.

The following table summarizes the TULIB DD/DLBL names.

DD/DLBL Description
SYSPRINT/SYSLST Listing file
z/OS Default DCB: RECFM=FBA, LRECL=133
z/VSE DEVADDR=SYSLST
SYSIN/SYSIPT Sequential input file for control statements
z/OS Default DCB: None.
z/VSE DEVADDR=SYSIPT

TULIB Conventions

The following table summarizes the TULIB coding conventions.

Feature Convention
SYSIN/SYSIPT Sequential input statements:
Column 1: CAT, DEL or REF
Column 5: Program name, parameters
PARM SYSPARM None
User Exits None
Return Codes
00 Normal completion.
04 One or more catalog requests failed
08 Node/SVC wrong
16 Error in Access-Interface