SERNET Environment Parameter List - SYSTEM ENVIRON LIST
This function accepts a required setup keyword — "ENVIRON" — as input. It returns the values of several parameters associated with the SERNET system environment in which the current instance of ChangeMan ZMF operates. These include server date and time, chunk size, and whether or not SERNET communication is enabled between ChangeMan ZMF and selected file management systems, job scheduling systems, and Serena products.
The Serena XML service/scope/message tags and attributes for a SERNET environment parameter list message are:
<service name="SYSTEM">
<scope name="ENVIRON">
<message name="LIST">
These tags appear in both requests and replies.
SYSTEM ENVIRON LIST — Requests
The syntax of a SERNET environment parameter list request is virtually identical to that for a system setup parameter list request. (See Exhibit 12-1.) However, the <systemTypeDesc> tag takes a special keyword: "ENVIRON". This value is case-sensitive.
The example shows exactly how you should code your SERNET environment parameter list request. As always, the <header> data element is required only for batch jobs. (See <header> Tag.)
SYSTEM ENVIRON LIST — Replies
This function returns one <result> data element containing the requested parameters and values. Following the <result> data structure is the standard <response> data structure, 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-4.
Exhibit 12-4 SYSTEM ENVIRON LIST <result> Data Structure
| Subtag | Use | Occurs | Data Type & Length | Values & Dependencies |
|---|---|---|---|---|
| <chunkSize> | Optional | 0 - 1 | String (8), variable | ZMF started task chunk size in bytes. |
| <cmnDesDevStatus> | Optional | 0 - 1 | String (1) | Code for license status of ChangeMan ZDD. Values: 0 = Not licensed 2 = Licensed |
| <cmnStatus> | Optional | 0 - 1 | String (1) | Code for license status of ChangeMan ZMF. Values: 0 = Not licensed 2 = Licensed |
| <cpxStatus> | Optional | 0 - 1 | String (1) | Code for license status of Comparex. Values: 0 = Not licensed 2 = Licensed |
| <currentSystemApplid> | Optional | 0 - 1 | String (3) | Current system application (for example CMN). |
| <currentSystemDateStamp> | Optional | 0 - 1 | Date, yyyymmdd | Current system date. |
| <currentSystemTimeStamp> | Optional | 0 - 1 | Time, hhmmss | Current system time, 24-hour format |
| <db2Status> | Optional | 0 - 1 | String (1) | Code for license status of IBM DB2. Values: 0 = Not licensed 1 = Licensed & inactive 2 = Licensed & active |
| <eclStatus> | Optional | 0 - 1 | String (1) | Code for license status of Eclipse. Values: 0 = Licensed 2 = Not licensed |
| <endevorStatus> | Optional | 0 - 1 | String (1) | Code for license status of Endevor. Values: 0 = Licensed 2 = Not licensed |
| <hfsStatus> | Optional | 0 - 1 | String (1) | Code for SERNET support status of IBM hierarchical file system (HFS). Values: 0 = Supported 2 = Not supported |
| <hsmStatus> | Optional | 0 - 1 | String (1) | Code for SERNET support status of IBM hierarchical storage management system (HSM). Values: 0 = Supported 2 = Not supported |
| <imsStatus> | Optional | 0 - 1 | String (1) | Code for license status of IBM IMS. Values: 0 = Not licensed 1 = Licensed & inactive 2 = Licensed & active |
| <libStatus> | Optional | 0 - 1 | String (1) | Code for SERNET support status of CA Librarian. Values: 0 = Supported 2 = Not supported |
| <panStatus> | Optional | 0 - 1 | String (1) | Code for SERNET support status of CA Panvalet. Values: 0 = Supported 2 = Not supported |
| <passphrase> | Optional | 0 - 1 | String (1) | Code for support status of passphrase. Values: 0 = Supported 2 = Not supported |
| <pdseStatus> | Optional | 0 - 1 | String (1) | Code for SERNET support status of IBM PDSE file system. Values: 0 = Supported 2 = Not supported |
| <sdsbStatus> | Optional | 0 - 1 | String (1) | Code for SERNET support status of SDSB. Values: 0 = Supported 2 = Not supported |
| <serverCCSID> | Optional | 0 - 1 | String (5) | Server CCSID |
| <serverVersion> | Optional | 0 - 1 | String (5) | Server version. |
| <starToolStatus> | Optional | 0 - 1 | String (1) | Code for license status of StarTool FDM. Values: 0 = Not licensed 2 = Licensed |
| <syncTracStatus> | Optional | 0 - 1 | String (1) | Code for license status of ChangeMan SSM. Values: 0 = Not licensed 2 = Licensed |
| <unicodeNationalChars> | Optional | 0 - 1 | String (12), variable | Unicode national characters in hex. |
| <xchStatus> | Optional | 0 - 1 | String (1) | Code for license status of ChangeMan ZDD/ XCH. Values: 0 = Not licensed 2 = Licensed |
| <xjrJesType> | Optional | 0 - 1 | String (1) | Job review JES type. Values: 0 = Not supported 2 = JES2 3 = JES3 |
| <xjrStatus> | Optional | 0 - 1 | String (1) | Code for license status of IBM job review system. Values: 0 = Not licensed 1 = Licensed & inactive 2 = Licensed & active |
| <xsdStatus> | Optional | 0 - 1 | String (1) | Software delivery status. Values: 0 = Not licensed 2 = Licensed |
...