Creating Configuration Items for unique address spaces

<sysplex>...</sysplex>

Address space affinity definition

Valid values are as follows:

• YES—The object can run on any z/OS image in the sysplex (a CICS region).
  The server is associated with the sysplex and not the system. If the same server is discovered and has moved from one system to another, it is still treated as the same server.
• NO—The object must run on that specific z/OS image or LPAR (JES2).
  The server is treated as a new server if it moves from system to system. (The system name is added to the CI name.)

Default <sysplex> values for specific types of servers are listed in MDZTTD00 default values. 

USS command name that runs as a process under USS for the object you want to discover

The command name is a mask field that specifies which processes should generate an instance of this CI. The mask uses a question mark (?) to represent any single character and an asterisk (*) to represent any number of characters. For example, the following cmdnm statement discovers all processes with the command names is "FTPD", "ftpd",  or "/usr/sbin/ftpd".

<cmdnm>FTPD</cmdnm>

(Optional) Mask for the names of jobs or started tasks you do not want to discover

The following example creates CIs only for started task PRODPAS running program MDZ9DZ00:

<object> 
 <type>PAS</type> 
 <class>RESOURCE</class> 
 <vendor>BMC</vendor> 
 <pgmid>MDZ9DZ00</pgmid> 
 <include>PRODPAS</include> 
</object>

(Optional) Mask for the names of jobs or started tasks that you do not want to discover

Normally, a CI is created for all CICS regions that are found. You can use an <exclude> statement to exclude a job or task. In the following example, the started task named TESTCICS is not discovered:

<object>
  <type>CICS</type>
  <class>TRANSACTION</class>
  <vendor>IBM</vendor>
  <exclude>TESTCICS</exclude>
</object>

The following example creates CIs for any started task that is running the program MDZ9DZ00 except for the started task named TESTPAS.

<object>
  <type>PAS</type>
  <class>RESOURCE</class>
  <vendor>BMC</vendor>
  <pgmid>MDZ9DZ00</pgmid>
  <exclude>TESTPAS</exclude>
</object>

(Optional) Mask of a command parameter used to start either an STC or USS process.

You can specify more than one <parm>...</parm> sequence for a given object.

The special mask characters are as follows:

• ?—Any character
• *—Any number of characters
• Aa–Zz, 0–9—Exact match

To extract values from the command parameter, use the following current mask variables:

• $VAR—Any number of characters
• $KEY—Primary key ID string for RELATE
• $SKY—Secondary key ID string for RELATE
• $VER—Version string
• $REL—Release string
• $MOD—Modification string
• $END—Marks the end of the text or mask string

 The returned version field is a combination of the $VER[.$REL][.$MOD] extracted strings.

In the following example, the <parm> statement discovers all address spaces that have MjeJvmTestSuit.jar as part of its start command, such as /shrd/java/J8.0_64/bin/java -jar /shrd/HOME/lib/MjeJvmTestSuit.jar. It also extracts 8.0 for the version string.                                           

<parm>java/J$VER_$VAR/MjeJvmTestSuit.jar</parm>

(Optional) Mask for a subtask name that is specified as running under the job or started task name that you want to discover. You can specify more than one <subtask>...</subtask> sequence for a given object so that you can have multiple subtasks represent a given object. The mask special characters are as follows:

• ?—Any character

• *—Any number of characters
• Aa–Zz, 0–9—Exact match

In the following example, the subtask statement discovers all address spaces with a subtask name that begins with IWMWBBR.

<subtask>IWMWBBR*</subtask>

(Optional) Address space type of the object that identifies the type of work an address space contains

For example, you can use STC for a Started Task address space:

<addrtype>STC</addrtype>

• ASC—ASCH (APPC) Address Space User                             
• BAT—Batch                                                      
• OMV—OpenMVS Address Space User                                 
• STC—Started Task                                               
• TSO—TSO User