How to define a STEPLIB to a TSO session for running DML/O in local mode

Document ID : KB000032464
Last Modified Date : 14/02/2018
Show Technical Document Details


There is a sample TSO clist for invoking DML/O in local mode in the .CAGJSAMP(USDTSO) member of the install libraries. It indicates that the user session must have a STEPLIB defined for it pointing to the CA-IDMS load library concantenation.

How do I do this?



There are two methods for doing this.


The following statement can be used in a clist to allocate a STEPLIB to your session:-

TSOLIB ACTIVATE DSNAME('your.idms.dba.loadlib' -
                       'your.idms.custom.loadlib' -

The above statement can be incorporated into the existing sample. However, the TSOLIB ACTIVATE command must be run from the TSO READY prompt (i.e. outside of ISPF). Therefore, if this solution is used, the clist must be invoked from the TSO READY prompt.

It is also possible to create a separate clist to just allocate the STEPLIB and invoke only that from the TSO READY prompt.

PROC 0                                                             
TSOLIB ACTIVATE DSNAME('your.idms.dba.loadlib' -     
                       'your.idms.custom.loadlib' -  

Then after running that separate clist from the TSO READY prompt, the normal sample clist can be invoked from ISPF option 6.


If you are using CA-SYSVIEW, the following statement can be used to allocate a STEPLIB.

STEPLIB DATASET('your.idms.dba.loadlib' -     
                'your.idms.custom.loadlib' -  

This can be executed from either ISPF or the TSO READY prompt.


Additional Information:

The sample clist for local mode DML/O can be found in the .CAGJSAMP(USDTSO) install library member.

See also the Installation and Maintenance Guide, Chapter 5 “Starting Your Product”, “Post-Configuration Tasks”, “Preparing TP Access Environment”, “TSO Access”.