SETXCF MODIFY command

Use the SETXCF MODIFY command to change current XCF parameters. The system changes only those parameters explicitly provided on the SETXCF MODIFY command; all other parameters associated with the resource remain the same.

Modify inbound paths
Modify outbound paths
Modify local message space
Modify transport classes
Modify CF structure alter permission
Modify sync/async conversion thresholds

The complete syntax for the SETXCF MODIFY command is:

 
SETXCF MODIFY,{PATHIN,{DEVICE=([/]indevnum[,[/]indevnum]...)}    }
                      {STRNAME=(strname[,strname]...)}      }    
                            [,MAXMSG=maxmsgbuffers]              
                                 [,RETRY=retrylimit]             
                                                                
              {PATHOUT,{DEVICE=([/]outdevnum[,[/]outdevnum]...)} }
                       {STRNAME=(strname[,strname]...)         } 
                            [,CLASS=classname]                   
                                 [,MAXMSG=maxmsgbuffers]         
                            [,RETRY=retrylimit]                  
              {STRNAME or STRNM={strname|ALL}, 
                     ALTER={DISABLED|ENABLED}}
                                                                
              {LOCALMSG,MAXMSG=maxmsgbuffers                     }
                  [,CLASS=class-name]                            
                                                                
              {CLASSDEF,CLASS=classname                          }
                  [,CLASSLEN=classlength]                        
                       [,MAXMSG=defaultmaxmsgbuffers]            
                  [,ADDGROUP=(groupname[,groupname]...)]         
                       [,DELGROUP=(groupname[,groupname]...)]    
              {SYNCASYNC,
                  [SIMPLEX={value | DEFAULT}]
                       [ DUPLEX={value | DEFAULT}  ]
                       [ LOCKSIMPLEX={value | DEFAULT} ]
                       [ LOCKDUPLEX={value | DEFAULT} ]
                      }

The parameters are:

PATHIN or PI,DEVICE= or DEV=([/]indevnum[,[/]indevnum]...) [,RETRY=retrylimit]

Specifies the device number of one or more inbound signalling paths. A device number, indevnum, is 3 or 4 hexadecimal digits, optionally preceded by a slash (/). If you specify only one device, you do not need to enter the parentheses.

Use the RETRY keyword to modify the retry limit and the MAXMSG keyword to modify the amount of message buffer space. You must specify at least one of the MAXMSG or RETRY keywords. The MAXMSG value must be a number from 1 to 999999.

PATHIN or PI,STRNAME or STRNM=(strname[,strname]...)

Specifies the name of one or more coupling facility structures that are associated with defined XCF inbound signalling paths and that are to be modified.

The structure name can be up to 16 alphanumeric characters long, and must begin with an uppercase alphabetic character. If you specify only one structure name, you do not need to enter the parentheses.

PATHOUT or PO,DEVICE or DEV=([/]outdevnum[,[/]outdevnum] [,MAXMSG=maxmsgbuffers][,RETRY=retrylimit]

Specifies the device number of one or more outbound signalling paths. A device number, outdevnum, is 3 or 4 hexadecimal digits, optionally preceded by a slash (/). If you specify only one device, you do not need to enter the parentheses.

Use the RETRY keyword to modify the retry limit, the CLASS keyword to modify the transport class assignment, and the MAXMSG keyword to modify the amount of message buffer space. You must specify at least one of the MAXMSG, CLASS, or RETRY keywords. The MAXMSG value must be a number from 1 to 999999.

PATHOUT or PO,STRNAME or STRNM=(strname[,strname]...)

Specifies the name of one or more coupling facility structures that are associated with defined XCF outbound signalling paths and that are to be modified.

STRNAME or STRNM={strname|ALL}

Specifies a structure name pattern identifying the name of one or more coupling facility structures that are to be modified. The structure name pattern can be up to 16 characters long. ALL or * can be specified to modify all structures, or a valid structure name followed by an optional wildcard (*) suffix can be specified. A valid structure name begins with an uppercase alphabetic character (A – Z) and can also contain numeric characters and the four special characters: $, @, #, _.

ALTER=DISABLED: CF structure alter processing is to be disabled for matching structures. Starting CF structure alter processing for such structures are not permitted.
ALTER=ENABLED: CF structure alter processing is to be enabled for matching structures.

LOCALMSG or LM,MAXMSG=maxmsgbuffers [,CLASS=classname]

Within a particular transport class, you can modify the amount of message buffer space made available for local message traffic after the creation of the class definition. The total amount of buffer space for the transport class (indicated by the optional keyword CLASS) is maxmsgbuffers plus the value specified or defaulted to on the MAXMSG parameter on the CLASSDEF statement of the COUPLExx parmlib member. The MAXMSG value must be a number from 1 to 999999.

If you omit CLASS, the change affects the default transport class, named DEFAULT.

CLASSDEF or CD,CLASS=classname

Specifies the transport class to be modified. You must specify at least one of the CLASSLEN, MAXMSG, ADDGROUP, or DELGROUP keywords.

[,CLASSLEN=classlength]: Use the CLASSLEN keyword to modify the message length.
MAXMSG=defaultmaxmsgbuffers: Use the MAXMSG keyword to modify the message buffer space. By changing the MAXMSG value, you change the amount of message buffer space initially allotted to each system for the indicated transport class. However, changing the MAXMSG value does not affect it for any existing resource — such as an outbound XCF path — in the class. The MAXMSG value must be a number from 2 to 999999. See z/OS MVS Setting Up a Sysplex for further information about determining message buffer space.
ADDGROUP=(groupname[,groupname]...): Specifies one or more groups to be added to the set of groups assigned to the transport class. Groups, possibly including undesignated groups, were assigned to this class when it was created. Explicitly assigning a group to this class does not delete the UNDESIG group from the class.
The group name groupname must be specified as one to eight alphanumeric and national ($,#,@) characters, and may begin with any of these characters.
DELGROUP=(groupname[,groupname]...): One or more groups to be deleted from the set of groups assigned to the transport class. If this command deletes the last assigned group from a transport class, XCF automatically assigns the undesignated groups to the class. If a transport class has no groups explicitly assigned to it, undesignated groups cannot be deleted from the class.
The group name groupname must be specified as one to eight alphanumeric and national ($,#,@) characters, and may begin with any of these characters.

SYNCASYNC

Allows the installation to define the thresholds at which the system will convert synchronous CF requests to run asynchronously.

Synchronous CF requests spin while waiting for the request to complete at the CF, consuming CPU resources. If the projected synchronous service time exceeds the defined threshold, z/OS will convert the request to run asynchronously. A lower threshold will cause more requests to run asynchronously, reducing CPU consumption but potentially elongating overall service time. A higher threshold will cause more requests to execute synchronously, increasing CPU consumption but potentially improving throughput.

Exactly one of the SIMPLEX, DUPLEX, LOCKSIMPLEX, or LOCKDUPLEX keywords must be specified with SYNCASYNC.

[SIMPLEX={value | DEFAULT}]: Use the SIMPLEX keyword to set the synchronous / asynchronous conversion threshold, in microseconds, for simplex requests to structures other than lock structures. A specification of DEFAULT indicates that the system-determined threshold is to be used. The SIMPLEX value must be a number from 1 to 10000.
[DUPLEX={value | DEFAULT}]: Use the DUPLEX keyword to set the synchronous / asynchronous conversion threshold, in microseconds, for duplex requests to structures other than lock structures. A specification of DEFAULT indicates that the system-determined threshold is to be used. The DUPLEX value must be a number from 1 to 10000.
[LOCKSIMPLEX={value | DEFAULT}]: Use the LOCKSIMPLEX keyword to set the synchronous / asynchronous conversion threshold, in microseconds, for simplex requests to lock structures. A specification of DEFAULT indicates that the system- determined threshold is to be used. The LOCKSIMPLEX value must be a number from 1 to 10000.
[LOCKDUPLEX={value | DEFAULT}]: Use the LOCKDUPLEX keyword to set the synchronous / asynchronous conversion threshold, in microseconds, for duplex requests to lock structures. A specification of DEFAULT indicates that the system- determined threshold is to be used. The LOCKDUPLEX value must be a number from 1 to 10000.