z/OS ISPF Services Guide
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


QBASELIB—query base library information

z/OS ISPF Services Guide
SC19-3626-00

The QBASELIB service enables an ISPF dialog to obtain the current Library information for a specified DDNAME. For a specified ddname, the data set names allocated to that ddname are returned in a dialog variable.

Command invocation format

Read syntax diagramSkip visual syntax diagram
>>-ISPEXEC--QBASELIB--dd-name--+------------+------------------><
                               '-ID(id-var)-'   

Call invocation format

Read syntax diagramSkip visual syntax diagram
>>-CALL--ISPEXEC--(buf-len,--buffer);--------------------------><

or

Read syntax diagramSkip visual syntax diagram
>>-CALL--ISPLINK--('QBASELIB'--,dd-name,,-+-id-var)-+----------><
                                          '-'b'-----'   

Parameters

dd-name
Specifies the ddname that is being queried. The value can be ISPPLIB, ISPMLIB, ISPSLIB, ISPTLIB, ISPLLIB, ISPTABL, ISPFILE, or any valid base DDNAME.
id-var
Optional parameter that specifies the name of a dialog variable which is to contain "ID" information. It is set to the data set name or names of the ddname that was specified in the service call. All data set names returned are fully qualified. Multiple data set names are separated by a comma. TSO has a maximum of 255 data set names allowed in the data set list. A data set name list is bounded by parenthesis when the QBASELIB service is requested through ISPLINK. The variable is not modified if the ddname specified is not allocated. It is the responsibility of the dialog developer to initialize this variable.
Note: Id-var should be initialized to blanks before every QBASELIB call.
buf-len
Specifies a fullword fixed binary integer containing the length of "buffer".
buffer
Specifies a buffer containing the name of the service and its parameters in the same form as they would appear in an ISPEXEC call for a command procedure.

Return codes

These return codes are possible:
 0
A DDNAME for the specified ddname exists and the requested information has been successfully returned.
 4
The specified dd-name is not defined.
16
A dialog variable translation or truncation error has occurred.
20
A severe error has occurred.

Example

A base library for messages (ISPMLIB) is defined. Query the "ID" information and return the "ID" information in the variable IDV.

Here is the command invocation

ISPEXEC QBASELIB ISPMLIB ID(IDV)

Here is the call invocation:

CALL ISPLINK ('QBASELIB','ISPMLIB ','IDV ');

Or alternatively, you could:

  1. Set the program variable BUFFER to contain
    QBASELIB ISPMLIB ID(IDV)
  2. Set program variable BUFLEN to the length of the variable BUFFER.
  3. Issue the command
    CALL ISPEXEC (BUFLEN, BUFFER);

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014