|
Command Purpose:
Parameters
Syntax The complete syntax for the SET command is: SET or T T [[DATE=yyyy.ddd][,CLOCK=hh.mm.ss]][RESET] [,IPS=xx][,OPT=xx][,ICS=xx][,SMF=xx][,DAE=xx] [,MPF={(xx[,xx]...)|NO}] [,SLIP=xx][,PFK=xx][,IOS=xx][,EXS=xx][,SMS=xx][,MMS={xx|NO}][,PROG=xx] [,DIAG=xx][,GRSRNL=(xx[,xx]...)] [,APPC=(xx[,xx]...,L)][,ASCH=(xx[,xx]...,L)] [,SCH=(xx[,xx]...,L)] [,CNGRP={(xx,[xx]...)}|NO ][,PROD=(xx[,xx]..)] [,OMVS=(xx[,yy...,nn]) [,RTLS=(xx[,xx...]) Note: You may specify the operands in any order, and must specify at least one operand. Do not put a comma before the first operand you specify. If you specify DATE or RESET in a position other than the first, be sure to precede it with a comma. If you specify only one parmlib member with APPC=, ASCH=, SCH=, GRSRNL=, CNGRP=, MPF=, OMVS=, or RTLS=, you do not need to enter the parentheses. Parameters DATE=yyyy.ddd The local date, where v yyyy is the year, in the range 1900-2042, and v ddd is the day, in the range 001-366. Notes: 1. The most distant date in the future you may specify is 2042.260. 2. The year must be within seventy (70) years of the GMT date or the system ignores the entire SET command. 3. You must specify the year yyyy using four digits. 4. If you specify a new time that implies a change of date, you must explicitly specify the new local date. CLOCK=hh.mm.ss The local time in hours (00-23), minutes (00-59), and seconds (00-59). Chapter 4. MVS System Commands Reference 4-339 Notes: 1. The system does not change the date when the new time implies a change of date; if you want a new date, use the DATE parameter or wait for the time to pass midnight. 2. If you specify CLOCK for day 2042.260, the last allowable date, the clock value must not exceed 23.53.47. Later values may cause unpredictable results. RESET The time zone constant which is used to calculate the local date and time is reset to the value that was read in from the CLOCKxx member of the logical parmlib during system initialization. The local date and time are changed accordingly. When you specify RESET, omit DATE and CLOCK. The following parameters determine which members of the logical parmlib the system is to use. Use them only at the direction of the system programmer. For more information on members of the logical parmlib, see OS/390 MVS Initialization and Tuning Guide. IPS=xx The two alphanumeric characters indicating the IEAIPSxx member of the logical parmlib that contains the new parameters SRM is to use. Note: The SET IPS command is not valid on systems operating in workload management goal mode. The command is supported on systems operating in workload management compatibility mode. OPT=xx The two alphanumeric characters indicating the IEAOPTxx member of the logical parmlib that contains the new parameters SRM is to use. ICS=xx The two alphanumeric characters indicating the IEAICSxx member of the logical parmlib that contains the new installation control specifications SRM is to use. Note: The SET ICS command is not valid on systems operating in workload management goal mode. The command is supported on systems operating in workload management compatibility mode. SMF=xx The two alphanumeric characters indicating the SMFPRMxx member of the logical parmlib containing the parameters MVS/ESA is to use when restarting SMF. DAE=xx The two alphanumeric characters indicating the ADYSETxx member of the logical parmlib that contains the new parameters that dump analysis and elimination (DAE) program is to use. Note: The OPT=, ICS=, SMF=, and DAE= parameters affect the jobs in progress as well as the jobs read and scheduled after the command. MPF=(xx[,xx]...) The two alphanumeric characters indicating the MPFLSTxx members of the logical parmlib that are concatenated to form the MPF table. xx can represent: v The message(s) being suppressed by MPF v The action message(s) not being retained by the action message retention facility SET Command 4-340 OS/390 V2R10.0 MVS System Commands v The installation exit(s) to receive control for selected messages v The status of the general WTO installation exit IEAVMXIT v Whether this message is automated by MPF v The MPFLSTxx member that identifies the message id, color attribute, or command installation exit definition v What color, intensity, and highlighting capabilities are in effect v The status of the command installation exit routines specified in the logical parmlib member MPFLSTxx The MPF parameter on the INIT statement in the CONSOLxx member of the logical parmlib controls which, if any, MPFLSTxx members are active at IPL. MPF=NO Ends MPF processing (message suppression and presentation). NO is ignored when specified in combination with a 2-character suffix. SLIP=xx The two alphanumeric characters indicating the IEASLPxx member of the logical parmlib that contains the commands SLIP processing is to use. PFK=xx The two alphanumeric characters indicating the PFKTABxx member of the logical parmlib that contains the PFK tables that are to be available for a console. The PFK(xx) keyword on the INIT statement in CONSOLxx identifies the PFKTABxx member that is available at IPL. Note: The CONTROL command (K N,PFK=nnnnnnnn) must be issued to invoke the PFKTABxx member specified in the SET command. SMS=xx The two alphanumeric characters indicating the IGDSMSxx member of the logical parmlib that contains the parameters the system is to use when it starts SMS. Specifying SMS=xx also starts SMS if it was not started at IPL or, restarts SMS if it has stopped and can’t restart itself. Depending on the setting of the PROMPT keyword in the IEFSSNxx member of SYS1.PARMLIB, this command can display the parameters in the IGSMSxx member. (For a comparison of the SET SMS command with the SETSMS command, see Table 4-30 on page 4-388.) You can use SET SMS=xx to specify an IGDSMSxx parmlib member containing PDSESHARING(EXTENDED) to migrate members of a sysplex to PDSE extended sharing. This SET SMS command must be routed to every system that was operating with a PDSESHARING(NORMAL) parmlib member. This SET SMS for EXTENDED establishes that system’s preference, and causes it to communicate with the other sysplex members that it would like to switch to EXTENDED sharing. When all members have requested EXTENDED sharing, the sysplex can migrate to that level of sharing. You may have to issue the SET SMS=xx a second time to trigger the switch from NORMAL to EXTENDED sharing. Each of the systems will issue message IGW306I when it migrates to EXTENDED sharing. MMS=xx When the MVS message service (MMS) is not active, SET MMS=xx starts the message translation service. When MMS is active, SET MMS=xx changes the MMSLSTxx member. The two alphanumeric characters indicate the MMSLSTxx member of the logical parmlib the system is to use. SET Command Chapter 4. MVS System Commands Reference 4-341 MMS=NO Ends MMS processing and frees all allocated resources. GRSRNL=(xx[,xx]...) The two alphanumeric characters indicating the GRSRNLxx member(s) of the logical parmlib that contain the specified GRS resource name lists. GRSRNL allows you to change the current RNLs specified in one or more GRSRNLxx member of SYS1.PARMLIB. Do not use parentheses when only one parmlib member is specified. For more detail on the use of the SET GRSRNL command, see OS/390 MVS Planning: Global Resource Serialization. Attention: You cannot specify the GRSRNL= parameter if GRSRNL has already been set to EXCLUDE in the logical parmlib member IEASYSxx. IOS=xx The two alphanumeric characters indicating the IECIOSxx member of the logical parmlib that contains the parameters the system is to use to control MIH processing and I/O timing processing. The MIH timing intervals or the I/O timing intervals or the MIH timing intervals and the I/O timing intervals are changed ONLY for devices that have MIH statements coded in IECIOSxx. Notes: 1. IECIOSxx may also contain parameters that control hot I/O processing. Using SET IOS=xx to change to another member does not affect the hot I/O parameters; hot I/O processing is unchanged. Hot I/O processing parameters can only be changed at system initialization time in response to message IEA101A. 2. During IPL (if the device is defined to be ONLINE), or during the VARY ONLINE process, some devices may present their own MIH timeout values, via the primary/secondary MIH timing enhancement contained in the self-describing data for the device. The primary MIH timeout value is used for most I/O commands. However, the secondary MIH timeout value may be used for special operations such as long-busy conditions or long-running I/O operations. Any time a user specifically sets a device or device class to have an MIH timeout value that is different from the IBM-supplied default for the device class, that value will override the device-established primary MIH time value. This implies that if an MIH time value that is equal to the MIH default for the device class is explicitly requested, IOS will NOT override the device-established primary MIH time value. To override the device-established primary MIH time value, you must explicitly set aside a time value that is not equal to the MIH default for the device class. Note that overriding the device-supplied primary MIH timeout value may adversely affect MIH recovery processing for the device or device class. Please refer to the specific device’s reference manuals to determine if the device supports self-describing MIH time values. EXS=xx The two alphanumeric characters indicating the EXSPATxx member of the logical parmlib that contains the excessive spin recovery actions and the excessive spin loop timeout interval. SET Command 4-342 OS/390 V2R10.0 MVS System Commands APPC=(xx[,xx]...,L) The two alphanumeric characters indicating the APPCPMxx parmlib member that contains the desired APPC/MVS address space configuration that is appended to the existing configuration. The APPCPMxx member can reside in a logical parmlib or if no logical parmlib is specified, in any parmlib data set specified on an //IEFPARM DD statement in the master scheduler JCL. The L is optional and causes the system to display parmlib statements on the operator console as they are processed. ASCH=(xx[,xx]...,L) The two alphanumeric characters indicating the ASCHPMxx parmlib member that contains the desired APPC/MVS scheduler configuration that is appended to the existing configuration. The ASCHPMxx member can reside in a logical parmlib or if no logical parmlib is specified, in any parmlib data set specified on an //IEFPARM DD statement in the master scheduler JCL. The L is optional and causes the system to display parmlib statements on the operator console as they are processed. SCH=(xx[,xx]...,L) The two alphanumeric characters indicating the SCHEDxx members of the logical parmlib that contain the desired program properties table (PPT) configuration. The L is optional and causes the system to display parmlib statements on the operator console as they are processed. The SET SCH command causes the system to replace the current PPT definitions with the IBM-supplied default PPT definitions and the PPT definitions from one or more SCHEDxx members that you specify on the command. The effect of the command is not cumulative. The new PPT definitions take effect immediately, without requiring a re-IPL of the system. Notes: 1. The SET SCH command only affects the PPT configuration statement. 2. If the SET SCH command fails, the current PPT configuration remains active. CNGRP=(xx,[xx]...) The two alphanumeric characters indicating the CNGRPxx member of the logical parmlib to be activated. This data is broadcast across the sysplex. It references the logical parmlib only on the system where the command executes, and activates only the CNGRPxx members found in that logical parmlib. CNGRP=NO The system is to remove all active console group definitions from the sysplex. PROG=xx The two alphanumeric characters indicating the PROGxx member of the logical parmlib containing definitions that: v Control the format and contents of the list of APF-authorized libraries v Control the use of exits and exit routines v Control the LNKLST concatenation by defining and modifying LNKLST sets v Control the addition of modules to, and removal of modules from, the LPA after IPL You can use the SET PROG=xx command to control exits previously defined to the dynamic exits facility. Dynamic exits services are implemented by: v The EXIT statement of the PROGxx parmlib member. The EXIT statement of PROGxx allows an installation to add exit routines to an exit, delete an exit SET Command Chapter 4. MVS System Commands Reference 4-343 routine for an exit, change the state of an exit routine, change the attributes of an exit, and undefine an implicitly defined exit. SET Command SETDMN Command Use the SETDMN command to change existing values of parameters in a single domain. Issue the SETDMN command only at the direction of the system programmer. The keywords that are valid for a given execution of the SETDMN command are determined by: 1. The keywords specified in the current domain description table. 2. The values specified in the current installation performance specification (IPS). At the system programmer’s direction, using the SETDMN command, you can change the relative service distribution among domains. The relative service is specified as a range of service rates for each domain, or as a fixed contention index (FIXCIDX). Each relative service rate pair can be specified as an average service per ready address space (ASRV) in the domain or as domain service totals (DSRV). FIXCIDX is specified as a constant value which determines the relative importance of the domain, regardless of the amount of service the domain consumes. Note: The SETDMN command is not valid on systems operating in workload management goal mode. The command is supported on systems operating in workload management compatibility mode. Syntax The syntax of the SETDMN command is: SETDMN or SD SD domainnum,{MIN=n1[,MAX=n2][,ASRV=(n0,n9) ] } { |,DSRV=(n0,n9) } { |,FIXCIDX=nnn } { } {{ASRV=(n0,n9)}[,MIN=n1][,MAX=n2] } {{DSRV=(n0,n9)} } {{FIXCIDX=nnn } } { } {MAX=n2[,ASRV=(n0,n9) ][,MIN=n1] } { |,DSRV=(n0,n9) } { |,FIXCIDX=nnn } Restrictions There are no defaults in the SETDMN command. At least one keyword must be specified. Duplicate keywords cannot be specified. Keywords can be specified in any order. Specifying the ASRV, DSRV, or FIXCIDX keywords overrides any previous value set for them either in the current IPS or in another SETDMN command. The value for n2 in the MAX=n2 parameter must be greater than or equal to the value of n1. Parameters domainnum The domain table entry (1-128) to be modified. 4-348 OS/390 V2R10.0 MVS System Commands MIN=n1 The minimum multiprogramming level (0-999). MAX=n2 The maximum multiprogramming level (0-999). ASRV=(n0,n9) Allows you to specify the average service per ready address space in the domain. The value range is 0-999999999. DSRV=(n0,n9) Allows you to specify the total service rate for each domain. The value range is 0-999999999. FIXCIDX=nnn Allows you to specify the fixed contention index value for each domain. The value range is 0-655. Note: For more details about using SETDMN command parameters, see OS/390 MVS Initialization and Tuning Guide. Example 1 To set the maximum multiprogramming level (MPL) to 2 in domain 5, enter: SETDMN 5,MAX=2 All other values in domain 5 remain unchanged. Example 2 To set the minimum MPL to 3 and the maximum MPL to 4 in domain 6, enter: SD 6,MIN=3,MAX=4 Example 3 For domain 2, to set the minimum MPL to 0, the maximum MPL to 255, and the relative service at (1,5000) to control the average service rate per domain, enter: SD 2,MIN=0,MAX=255,ASRV=(1,5000) Example 4 To set the contention index of domain 4 to a constant value of 300, enter: SD 4,FIXCIDX=300 SETDMN Command TRACE Command Use the TRACE command to: v Start, stop, or modify system trace v Start, stop, or modify master trace v Start, stop, or modify component trace v Start, stop, or modify transaction trace v Display the current status of system trace, master trace, component trace, and transaction trace During system initialization, or whenever you reactivate system trace after a system trace failure, the system creates a TRACE address space. That address space contains the system trace table. When the TRACE address space is created, the initial status of system trace (address space and explicit tracing functions) is on, the initial status of the branch tracing function of system trace is off, and the initial space set aside for system trace entries for each processor is 64K. You can issue TRACE ST, TRACE MT, TRACE CT, and TRACE TT only from the master console or another console with master authority. You can issue TRACE STATUS from any console. Syntax The complete syntax for the TRACE command is: TRACE TRACE [STATUS ] [ST[,nnnK][,BR={ON|OFF}] ] [ST[,OFF] ] [MT[,nnnK|,OFF] ] [CT{,WTRSTART=membername[,WRAP|NOWRAP] ]} ] [CT{,WTRSTOP=jobname} ] [CT{[ ,ON ],COMP=name[,SUB=(sub)][,PARM=mem]} ] [ |,nnnnK ] [ |,nnnnM ] [ |,OFF ] [TT[{,COLL|C=collection name }] ] {,CON=connection type } {,COR=correlation info } {,LU=logical unit name } {,LVL=level } {,NET=netid } {,PKG=package name } {,PLAN=|PL=plan name } {,PRF=perform } {,PROC|PR=proc name } {,PRS=process } {,SUB=subsystem } {,TC=transaction class } {,TRAN|T=transaction name} {,USER|U=userid } [,WTR=membername|STOP ] [,LATENT=Y|N ] [,BUFSIZ=nnnK|nnM} ] [,OFF={nn|ALL} ] Chapter 4. MVS System Commands Reference 4-513 | | Parameters STATUS The system is to display the current status of master trace. Status information includes the current size of the master trace table. The display tells the operator to use the DISPLAY TRACE command to obtain status for system and component trace. ST The system is to change the on or off status of system trace, the size of the system trace table, or the on or off status of the branch tracing function of system trace. Unless you specify ST,OFF, the system assumes you want to recreate the TRACE address space if it has terminated and turn system trace on if it is not on already. nnnK The amount of preferred, central storage in K bytes set aside for system trace table entries for each processor. You can specify for nnn any decimal number from 1 to 999. If you specify a number that is not a multiple of 4, the system rounds it up to the next multiple of 4. If you omit this parameter, the system assumes 64K for each processor, or the size established by the last TRACE command during the IPL that specified a table size. BR=ON or OFF The system is to turn on or turn off the branch tracing function of system trace. The address space and explicit tracing functions remain on as long as system trace remains on. If you omit this parameter, the system assumes that the status of branch tracing remains unchanged. BR=ON is intended for use in system software problem determination and diagnosis situations only. Branch tracing consists of tracing these four types of branches: v Branch and stack (BAKR) v Branch and link (BALR) v Branch and save (BASR) v Branch and save and set mode (BASSM) By enabling branch tracing you may be impacting system performance. Note: You can not specify the BR= parameter if you specify ST=OFF. OFF The system is to stop system trace and free the system trace table. The system does not terminate the TRACE address space. Therefore, if you start system trace again while the TRACE address space is still active, the on or off status of the different system trace functions and the size of the system trace table return to the values they had the last time system trace was on. MT The system is to change the on or off status of master trace or the size of the master trace table. Unless you specify MT,OFF, the system assumes you want to turn turn master trace on if it is not on already. nnnK The master trace table size you want the system to use. You can specify for nnn any decimal number from 16 to 999. If a master trace table already TRACE Command 4-514 OS/390 V2R10.0 MVS System Commands | | | | | | | exists, this new table replaces it. If you omit this parameter, the system assumes a table size of 24K, unless you specified a different table size in a previous TRACE command or, during system initialization, in a SCHEDxx member of SYS1.PARMLIB. OFF The system is to stop master trace. CT Specifies the component tracing options for an MVS component or an application. The system programmer will supply the trace parameters. To determine if the component to be traced allows the following parameters, see ″component traces″ in OS/390 MVS Diagnosis: Tools and Service Aids. WTRSTART=membername Identifies the name of the member that contains the source JCL that invokes a component trace external writer. The system also opens the data sets the writer uses. The member can be a SYS1.PROCLIB cataloged procedure or a job. Many installations use a cataloged procedure in SYS1.PROCLIB. After you enter a TRACE CT,WTRSTART command, you should turn the trace on and connect the writer with a WTR parameter in the reply for a TRACE CT command or in a parmlib member, if specified. WRAP or NOWRAP If you specify WRAP, when the system reaches the end of the data set or group of data sets, it writes over the oldest data at the start of the data set or the start of the first data set. If you specify NOWRAP, the system stops writing to the data set or sets when the data set or sets are full. If the WTRSTART parameter on the CTncccxx parmlib member or TRACE CT command specifies NOWRAP, the system uses the primary and secondary extents of the data set or sets. If the WTRSTART parameter specifies WRAP or omits the parameter, the system uses only the primary extent or extents. WTRSTOP=jobname Identifies the name of the job for a currently running component trace external writer that the system is to stop. The system also closes the data sets the writer used. The jobname is either: v Member name, if the source JCL is a procedure v Job name, if provided on a JOB statement within the source JCL Before you enter a TRACE CT,WTRSTOP command, you must either: v Turn the trace off, or v Disconnect the component trace external writer from the trace leaving the trace on. To disconnect the external writer while leaving the trace on enter the TRACE CT,ON command with WTR=DISCONNECT in the reply or in a CTncccxx parmlib member, if specified. If the trace is not turned off or disconnected from the writer, message ITT121I informs the operator of the condition and the writer will not stop. TRACE Command Chapter 4. MVS System Commands Reference 4-515 ON If the component trace is currently off, a TRACE CT,ON command turns it on. If the component trace is currently on and can be changed, a TRACE CT,ON command changes the trace options. An installation-supplied application trace can also have head level and sublevel traces, if specified in the CTRACE DEFINE macro that defined the trace. Whenever a trace that has sublevel traces is changed, all sublevel traces currently in the LIKEHEAD state will also be changed. Therefore, a change may cascade down a number of levels. A head trace may have been defined so that it is not allowed to be changed (HEADOPTS=NO on the CTRACE DEFINE macro). If this is the case, the trace is really just a place holder for options for other traces. nnnnK nnnnM Specifies the size, in kilobytes (K) or megabytes (M), of the trace buffer you want the system to use. Specifying the buffer size also turns the trace on. nnnnK is the buffer size in kilobytes, where nnnn is a decimal number from 1 to 9999. nnnnM is the buffer size in megabytes, where nnnn is a decimal number from 1 to 2047. When the size is not specified, the system uses the component-defined default or the size specified in a CTncccxx parmlib member. The size specified for an installation-supplied application trace must be within the range specified on the CTRACE DEFINE macro for the trace; see the programmer for the size value. OFF The system is to turn off tracing for the component. If the component is connected to a component trace external writer, the trace will be implicitly disconnected from the writer. Some components do not turn tracing completely off. Instead, they reduce the tracing activity to the minimum required for serviceability data in a dump. If the CTRACE DEFINE macro that defined the trace specified the MINOPS parameter, tracing is reduced to a minimum and component trace writes a message to the operator. If a component level trace has sublevel traces that are defined with the LIKEHEAD parameter on the CTRACE DEFINE macro, the sublevel traces will either be reduced to the minimal tracing or turned off, in the same manner as their head level component trace. COMP=name Identifies the component trace affected by the command. name is the external name for the component trace; it is provided for an IBM-supplied component and must be provided by a system programmer for an installation-supplied application trace. This parameter is required. SUB=(subname) Identifies a sublevel trace for a component or application with multiple traces. Subname is defined by the component or installation-supplied application. TRACE Command 4-516 OS/390 V2R10.0 MVS System Commands The SUB parameter is limited to a single subname; multiple subnames are not supported. If the sublevel trace name contains any national characters (@ # $ _), you must enclose the name in quotes. Otherwise, quotes are not required. In all cases you may specify the alphabetic characters in upper or lower case. If subname is a head level, all of the head’s sublevel traces that are defined with a LIKEHEAD=YES parameter inherit the options specified in the reply to this command. Therefore, the options you specify for a head level can affect many sublevel traces. Omitting the SUB parameter for a head level that is defined with HEADOPTS=YES affects all sublevel traces with the LIKEHEAD attribute. PARM=mem Identifies a SYS1.PARMLIB member that contains the options to be used for tracing. Using a parmlib member allows the operator to initiate the trace, change it, or stop it without a message prompting for options. Any option specified on the TRACE command overrides the option specified in the parmlib member. TT Specifies the transaction trace options. The system programmer will supply the trace parameters. To determine which trace parameters to use, see ″Specifying TRACE TT Options.″ For further information, see ″Transaction Trace″ in OS/390 MVS Diagnosis: Tools and Service Aids. TRACE Command
|
The information on this site is the combined effort of a lot of people,
please credit the authors if you use their information.
|