Skip to content

Installation Considerations

The INFO option requires that the Tivoli Information Management for z/OS Application Program Interface (API) be installed. See the Tivoli Information Management for z/OS Application Program Interface Guide for details.

The ChangeMan ZMF started task attaches and monitors the INFO subtask (module CMNINFAP) which services the input/output requests for Tivoli Information Management for z/OS data. The INFO subtask must have access to the Info/Sys load library (in particular, module BLGYSRVR) where the API resides.

The Info/Sys LINKLIB must be APF-authorized. If the Info/Sys LINKLIB is in the LINKLIST, CMNINFAP can load it directly. Otherwise, add the Info/Sys LINKLIB to the STEPLIB concatenation in the SERNET started task JCL.

//      DD DISP=SHR,DSN=somnode.INFO.LINKLIB        *Info/Sys Linklib

Diagnostic Messages

In the early stages of installing and tailoring the INFO Option interface, it is recommended that DDname APIPRINT be added to the started task procedure, for example:

//APIPRINT    DD SYSOUT=*      *Info/Family API Trace

This file acts as a trace of all activities, successful or unsuccessful. There is a slight performance penalty to be paid for this diagnostic assistance so it is recommended that it be removed when you have finished the implementation of the INFO Option.

Part of the duties of module CMNINFAP is to issue messages to DDname CMNPRINT. Some messages are considered severe and are also routed to the operator console. Most of the messages are suppressed unless the trace has been toggled to print by the console operator, as follows:

F CMNx,TRACE,PRINT

See the ChangeMan ZMF Installation Guide for more details on the impact of toggling the internal trace. All messages related to the INFO Option are in the 600 series:

CMNx061I - Attempting INFO API Connect CMNINFAP MVS-4.1.0) 92/01/31 23:56

An attempt is being made to connect the Info/Sys subtask with the API. If you have customized the module, the version (v.r.m), date, and time of the module is displayed in this message for feedback.

CMNx062I - INFO subtask complete

The INFO Option subtask connection was successful and is now ready for servicing requests.

CMNx063I - Unable to load BLGYSRVR - INFO API

An attempt was made to load the INFO Option server module and failed. There are three reasons for this to occur:

  1. The Info/Sys Linklib is not Linklisted.

  2. The Steplib concatenation was not done.

  3. The module was found but not loaded from an APF-authorized library.

In all cases, you will receive console messages describing the failure. In the first two cases, the messages will be

CSV003I REQUESTED MODULE BLGYSRVR NOT FOUND

CSV028I JOBNAME=cmnstart STEPNAME=CMNx

In the last case, the messages will be

CSV019I - REQUESTED MODULE BLGYSRVR NOT ACCESSED, IS IN NON-APF LIBRARY

CSV028I JOBNAME=cmnstart STEPNAME=CMNx

The INFO Option subtask connection cannot be made and message CMNx064I also will be issued.

CMNx064I - INFO subtask detached

The INFO Option subtask connection has failed and is detached for the duration of this Started Task.

CMNx065I - NOT A REAL PIDT - ABANDON TRAN

An attempt has been made to create, read, or update an INFO Option change record but the specified data table is missing or invalid.

CMNx066I - INFO; Tran=Txxx, RC=yyy, REAS=zzzzz, Change Record=nnnnnnnn

INFO transaction Txxx was attempted but failed with return code yyy and reason code zzzzz. Whatever change record was being requested is displayed as nnnnnnnn.

CMNx066I - INFO/SYS API TASK NOT ACTIVE; CONTACT GLOBAL ADMIN

INFO services were requested but the subtask was inactive.

CMNx066I - INFO/SYS API TASK DETACHED; CONTACT GLOBAL ADMIN

INFO services were requested but the subtask has been temporarily detached by the console operator.

CMNx067I - Disconnecting from INFO API

Either the entire started task is coming down or a specific request has been made by the console operator to DETACH the INFO interface.

CMNx068I - INFO; Structure word not found, sword=xxxxx

Structure word xxxxx was used to access data and could not be found in the PIDT. Considered severe and requires the attention of your INFO Option administrator.

CMNx069I - Sword=xxxxx,code=yy

Validation error yy was reported for structure word (S-word) xxxxx.

CMNINFAP Variables

As delivered, module CMNINFAP is generated for vanilla INFO Option access. That is, if you installed the INFO Option change management application exactly as IBM delivers without doing any customization, this interface will work with that predefined set of data tables. The load module CMNINFAP matches the source code CMNINFAP, as you might expect. If, however, you choose a session name, privilege class, and/or data table names other than those listed below, you must change them and regenerate module CMNINFAP. To do this, copy member CMNINFAP from the CMNZMF ASMSRC library delivered from Serena into your custom ASMSRC library for editing.

Change the values of the global variables to whatever is desired:

*=================================================================== 
* Below is where the user can tailor the source code for the shop.
*===================================================================
&SESSION SETC   'BLGSES00'      INFO invocation session name
&PRIVCLS SETC   'CHGMAN '       INFO privilege class name
&PIDTCRT SETC   'TS0B06C'       PIDT - create
&PIDTUPD SETC   'TS0B06U'       PIDT - update
&PIDTRET SETC   'TS0B06R'       PIDT - retrieve
*=================================================================== 
* Above is where the user can tailor the source code for the shop.
*===================================================================

...

CMNINFAP Variable Rules

BLGSES00 Default session name. Whatever is chosen must exist in the Info/Sys Linklib.
CHGMAN Default privilege class. Whatever is chosen must be reflected by the INFO Option administrator when authorizing access to the session name.
TS0B06C Specified data table for creating change records. Delivered as part of vanilla INFO Option change management application.
TS0B06U Specified data table for updating change records. Delivered as part of vanilla INFO Option change management application.
TS0B06R Specified data table for retrieving change records. Delivered as part of vanilla INFO Option change management application.

Save the member and assemble and link using member ASSEMBLE in the ChangeMan ZMF CNTL library.