Skip to content

ChangeMan ZMF STC DDNAME Libraries - DSS SERVICE STCLIST

This function retrieves the dataset and/or library concatenation list for a specified DDNAME associated with the ChangeMan ZMF started task that processes the request.

The Serena XML service/scope/message tags and attributes for a ChangeMan ZMF library concatenation list message are:

<service name="DSS">
<scope name="SERVICE">
<message name="LIST">

These tags appear in both requests and replies.

DSS SERVICE STCLIST — Requests

The request message for the library concatenation list function requires the DDNAME for the ChangeMan ZMF started task as input. Data structure details for the <request> tag appear in Exhibit 12-7.

Exhibit 12-7 DSS SERVICE STCLIST <request> Data Structure

Subtag Use Occurs Data Type & Length Values & Dependencies
<stcDDname> Required 1 String (8), variable JCL DDNAME in the ZMF started task procedure.

...

DSS SERVICE STCLIST — Replies

This function returns zero to many <result> data elements. Each <result> contains the fully qualified dataset name of a library, together with its ordinal position in the concatenation named in the request message by <stcDDname>.

Following the final <result> tag is the standard <response> data element, which indicates the success or failure of the XML request and provides a status message. Successful requests have a return code of 00. Unsuccessful requests have a return code of 04 or higher.

Data structure details for the <result> data element appear in Exhibit 12-8.

Exhibit 12-8 Library Concatenation List <result> Data Structure

Subtag Use Occurs Data Type & Length Values & Dependencies
<mvsLib> Optional 0 - 1 String (255), variable Fully qualified dataset name.
<mvsLibSequence> Optional 0 - 1 Integer (3), variable Ordinal position of <mvsLib> dataset in library concatenation for ZMF instance.