Defining the Adapter for InfoMan User ID and Session ID

The Adapter for InfoMan interfaces with the low-level InfoMan Application API. Since the low-level API acquires application parameters from the Program Interface Communications Area (PICA), the Adapter for InfoMan inputs certain pre-defined parameters to PICA.

PICA Parameters

How to:

Set Up the Adapter for InfoMan User ID, Privilege Class Name, and Session ID

PICA parameters of special interest to the Information/Management database administrators include:

PICAUSRN: Application ID or User ID
PICASESS: Session Member Name
PICACLSN: Privilege Class Name
PICADBID: Database ID
PICATINT: Transaction Time Interval

The Information/Management database uses the application ID PICAUSRN in conjunction with the privilege class name PICACLSN to establish the level of user accessibility permitted by the database.

If you specify a PICAUSRN (application ID) and/or PICACLSN (privilege class name) in an Access File, the Adapter for InfoMan uses it. If you do not, the Adapter for InfoMan inputs a PICAUSRN with a default eight-character value of SAMPID, and a PICACLSN with a default eight-character value of MASTER. During installation, these default values must be defined and recognized by the Information/Management database. The AUTOIMAN facility automatically creates the Access File with the specified PICAUSRN and PICACLSN values.

The PICASESS (session member name) is also defined in the Access File. If you do not specify a PICASESS value in the Access File, the default session name BLGSES00 is used. In order for your Information/Management database to recognize the default session name, you can define the default session BLGSES00 to your Information/Management database with full MASTER class privileges. The next topic explains how to set up the default user ID, class name, and session ID in the Information/Management database.

The PICATINT (transaction time interval) is the maximum time in seconds for a transaction to complete in the IBM API. Specify this parameter in the Access File

TINT=x

where:

x: Is the transaction time interval in seconds. 0 is the default value.

Top of page

Procedure: How to Set Up the Adapter for InfoMan User ID, Privilege Class Name, and Session ID

The following steps are required to set up the default Adapter for InfoMan user ID (or application ID), the default privilege class name, and the default session ID:

Define SAMPID as an eligible user ID accessible and available to the Information/Management database. The Adapter for InfoMan will interface to the low-level API with:
```
PICAUSRN='SAMPID'
```
You may use the Information/Management ISPF panels to do this. SAMPID must also be a member of the MASTER class with full privileges.
Define session BLGSES00 as a session with full privileges using the Information/Management ISPF panels. This session is a CSECT, and can be created, assembled, and link-edited by your Information/Management administrator. The session name BLGSES00 must be recognized and defined in the Information/Management database.
The session member BLGSES00 must be in a load library concatenation sequence available to Information/Management. Place the assembled and link-edited BLGSES00 member in STEPLIB DD of your server JCL.

Overriding the Default PICA Values in an Access File

You ca n override the default PICA values by specifying them in an Access File. The following table shows the PICA parameters, their Access File keywords, and their default values:

PICA Parameter	Access File Keyword	Default Value
PICAUSRN	USRN	'SAMPID'
PICASESS	SESS	'BLGSES00'
PICACLSN	CLSN	'MASTER'
PICADBID	DBID	5
PICATINT	TINT	0

To change a default in an Access File, edit the text following its keyword in the Access File. The following is an example of an Access File with some override values:

DBID=5,ITABLE=TS0032I,RTABLE=TS0032R,TINT=600,
SESS=MYSESS1,USRN=JOHN,CLSN=MASTER,$

In this example, DBID (database ID) and CLSN (privilege class name) specify the default values. SESS (session member name) has an override value that replaces BLGSES00, USRN (user ID) has an override value that replaces SAMPID, and the maximum transaction internal is set to 600 seconds.

Additional InfoMan Access File Parameters

You can include an IGNORE= parameter in the Access File to specify the processing action for database errors:

IGNORE=ALL	Allows all database errors to be processed as if they were not problematic. This is not recommended.
IGNORE=NONE	Allows no database errors to pass through. A message is issued, relevant data is logged in FSTRACE, and processing is halted.
IGNORE=TRUNC	Allows only field truncation errors to be passed through and the truncated data is returned. A message is logged in FSTRACE, and processing continues.

These errors indicate logical errors in the INFOMAN database. For more information, see the IBM API manual.