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. |