Previous Topic: Parameter LibrariesNext Topic: SCS Address Space Message Log (SCSLOG)


MSMCPARM Member

You can include the following elements in the MSMCPARM member documents that specify the address space parameters:

Data Recovery Parameters

Sets the parameters related to the SCS address space use of disk storage for data recovery purposes. The parameters are used when allocating data sets created to save existing data for recovery purposes.

The Data Recovery Parameters are specified using the following attributes:

dsnhlq

Specifies the data set name high-level qualifier used when allocating data sets created for data recovery purposes.

Limits: 1 to 17 bytes. The value can include static and dynamic system symbols and installation defined static system symbols.

Note: See the IBM z/OS MVS Initialization and Tuning Reference guide for a list of system symbols.

(Optional) &SYSUID

Specifies the user ID of the CA CSM user that initiated the configuration request for which data sets are created for recovery purposes.

Limits: The ampersand character (&) cannot be specified as a literal in the attribute value of an XML document. The character must be used to convert subsequent characters to a control sequence using the character string '&'.

Example: '&SYSNAME..MSM', dsnhlq='&SYSNAME..MSM'

Default: &SYSUID..MSMDATA

unit

Specifies unit name used when allocating z/OS data sets created for data recovery purposes.

Limits: 1 to 8 bytes

Default: None

volser

Specifies the volume serial number used when allocating data sets created for data recovery purposes.

Limits: 1 to 6 bytes. The characters of the serial number must be alphabetic, national, or a hyphen.

Default: None

mgmtclas

Specifies the SMS management class used when allocating data sets created for data recovery purposes.

Limits: 1 to 8 bytes. The first character of the class name must be alphabetic or national. Remaining characters must be alphanumeric or national.

Default: None

storclas

Specifies the SMS storage class used when allocating data sets created for data recovery purposes.

Limits: 1 to 8 bytes. The first character of the class name must be alphabetic or national. Remaining characters must be alphanumeric or national.

Default: None

TCP/IP

Specifies the address space parameters for the interface between the SCS address space and TCP/IP for communicating with other components of CA CSM.

The TCP/IP parameters are specified using the following attributes:

ipaddr

Specifies the IP address of the interface through which the SCS address space accepts TCP connection requests from other CA CSM components.

Limits: IPv4 address using standard dotted decimal notation.

(Optional) IPv6 address using one of the standard text forms that are defined in RFC 4291, IPv6

Example 1: 0.0.0.0

Example 2: ::

Note: The IPv4 unspecified address, 0.0.0.0, is used to indicate that the SCS address space accepts TCP connection requests through all IPv4 interfaces. The IPv6 unspecified address, :: , can be used to indicate that the SCS address space accepts TCP connection requests through all IPv4 and IPv6 interfaces.

Default: ::

port

Specifies the port number the SCS address space uses to listen for TCP connection requests from other CA CSM components.

Limits: 65535

Default: 49152

Console

Sets the parameters related to the SCS address space usage of extended MCS consoles that issue z/OS commands, receive command responses, and receive unsolicited message traffic.

The console parameters are specified using the following attributes:

prefix

Used in the construction of extended MCS console names.

Limits: 1 to 5 bytes. The first character must be alphabetic or national. Remaining characters must be alphanumeric or national.

Default: CAMSM

auth

Specifies the authority the extended MCS consoles have to issue z/OS commands.

The assigned authority specifies the commands that can be entered from the console. Separate multiple values with a blank space or a comma.

Enter one or more of the following values from the console:

MASTER

Allows the consoles to act as a master console, which issues all MVS commands.

ALL

Allows the consoles to issue system control commands, input/output commands, console control commands, and informational commands.

SYS

Allows the consoles to issue system control commands and informational commands.

IO

Allows the consoles to issue input/output commands and informational commands.

CONS

Allows the consoles to issue console control commands and informational commands.

INFO

Allows the consoles to issue informational commands.

Default: INFO

Note: SYS, IO, and CONS can be specified together in any combination. All others are mutually exclusive.

See the IBM z/OS MVS System Commands Reference guide for information about which commands can be entered from a console with a specific authority level.

Note: The security product settings override the console command authority settings for z/OS commands protected by a security product. For example, CA ACF2 for z/OS, if the OPERCMDS class is active and a profile is defined to protect the command.

SAF

Sets the parameters related to the SCS address space interface to the System Authorization Facility (SAF).

The SAF parameters are specified using the following attributes:

application

Specifies the application name assigned to the SCS address space.

Limits: 1 to 8 bytes. The first character must be alphabetic or national. Remaining characters must be alphanumeric or national.

Default: MSMCAPPL

requestor

Specifies the name assigned to the SCS address space that assigns a unique control point within a set of control points that exist in a subsystem.

Note: If you specify a requestor name and IBM RACF is installed, you must update the IBM RACF router table with a matching entry. If you do not update the table, IBM RACF processing is bypassed.

Limits: 1 to 8 bytes. The first character must be alphabetic or national. Remaining characters must be alphanumeric or national.

Default: None

subsystem

Specifies the subsystem name, version, and release level assigned to the SCS address space.

Note: If you specify a subsystem name and IBM RACF is installed, you must update the IBM RACF router table with a matching entry. If you do not update the table, IBM RACF processing is bypassed.

Limits: 1 to 8 bytes. The first character must be alphabetic or national. Remaining characters must be alphanumeric or national.

Default: None

SSL

Sets the parameters related to the SCS address space interface to the System SSL Cryptographic Services.

The SSL parameters are specified using the following attributes:

keyring

Specifies the path and file name of the key ring database file used for encrypting data from remote systems, or the SAF key ring label defined in the external security manager such as CA ACF2 for z/OS, CA Top Secret for z/OS, or IBM RACF for the user ID assigned to the SCS address space.

Used to retrieve the default certificate to send to the client side to begin the process of securing the connection for communication.

Default: None

stashfile

Specifies the path and file name of the stashfile if the key ring attribute is set to the path and file name of a key ring database file.

The stashfile contains the password to access the key ring database file.

Limits: Required if the key ring attribute is set to a key ring database file name.

Default: None

AUX

Sets the parameters that are related to the SCS AUX address space.

The SCS AUX address space parameters are specified using the following attributes:

procname

Specifies the name of a JCL procedure library member that contains the source JCL for the SCS AUX address space.

Limits: 1-8 bytes. The first character must be alphabetic or national. The remaining characters must be alphanumeric or national.

Default: MSMCAUX

jobname

Specifies the job name that is assigned to the SCS AUX address space.

Limits: 1-8 bytes. The first character must be alphabetic or national. The remaining characters must be alphanumeric or national.

Default: The JCL procedure library member name (if the source JCL is a procedure), or the job name that is assigned on the JOB statement (if the source JCL is a job).

reusasid

Determines if a reusable ASID is requested for the SCS AUX address space.

The SCS AUX address space receives one of the following values:

YES

The SCS AUX address space is assigned a reusable ASID if REUSASID (YES) is also specified in the DIAGxx PARMLIB member.

NO

The SCS AUX address space is not assigned reusable ASID.

Default: YES

Note: Using a reusable ASID results in an ABEND of system 0D3 if products or programs that are used in the configuration of a CA Technologies product are not upgraded to tolerate reusable ASIDs.

See the IBM z/OS MVS Programming: Extended Addressability Guide for more information about reusing ASIDs.

maxactive

Specifies the maximum number of concurrently active SCS AUX address spaces.

Limits: 1 to 20 numeric

Default: 20