MVS Operator Commands
Two MVS operator commands, Stop (P) and Modify (F), are used by MSO.
The STOP Command
The syntax for the STOP command is:
P jobname
where:
- jobname
- Is the MSO jobname or started task name.
After issuing this command, MSO comes down normally, as if stopped by MSOKILL.
The MODIFY Command
The syntax for the MODIFY command is as follows:
F jobname, [STOP]
F jobname, {CAN[CEL]|PURGE} {SECID|SID} = {securityid|*}
F jobname, {CAN[CEL]|PURGE} {LOGONID|LID} = {logon id|*}
F jobname, {CAN[CEL]|PURGE} TCB = tcb address
F jobname, {QUIESCE|ENABLE} [server]
F jobname, USERS
F jobname, DYNAM {ALLOC|FREE|CONCAT}
F jobname, RESTART CONSOLE
F jobname, CHAP TCB = tcbaddress,n
F jobname, SHUTDOWN {NOW|CANCEL}
F jobname, START server
F jobname, IDLELIM nnn
F jobname, TRACE trace_name [START] [,ACTive] [,SERVICE=service] [,COND]
[STOP] [,DEFer] [,USERID=security]
[level] [,TCB=address]
[QUERY [FULL|SHORT]]
where:
- jobname
- Is the MSO jobname or started task name.
- jobname STOP
- Brings down MSO the same way that the P (stop) command does. Thus, there are three ways to bring down MSO: using MSOKILL, the P operator command, or the F jobname, STOP operator command.
- CANCEL
- Can be used to cancel a logged-on MSO user. The CANCEL command accepts as a parameter the security ID or logon ID of the user to be canceled. All duplicate security ids or logon ids will also be canceled. Any processing done by the canceled ids is immediately terminated and the resources used by the ids are released. If an asterisk (*) is used instead of a security or logon ID, then all users are immediately canceled. PURGE and CAN are synonyms for CANCEL.
- securityid
- Is the MSO security ID or an asterisk (*).
- logon id
- Is the MSO logon ID or an asterisk (*),
- tcb address
- Is the address of the user's TCB
- QUIESCE
- Prevents any new users from logging on to the specified server, but allows all the existing users to continue processing. If a server is not specified, all servers are quiesced.
- ENABLE
- Allows new users to log on after a QUIESCE command is issued. Thus, ENABLE undoes the QUIESCE command. If a server is not specified, all servers are enabled; otherwise, only the specified service is enabled.
- USERS
- Displays on the console all the current users logged on to the MSO address space along with CPU and EXCP statistics for each of the users. If MSO usage accounting is not active (see MSO Usage Accounting) then CPU and EXCP statistics will not be present.
- DYNAM
- May be issued from the MVS system console. However, care should be taken to ensure that a DYNAM command will not adversely affect MSO's operation or FOCUS behavior before it is issued.
- ALLOC
- May be used to allocate additional files to the MSO region.
- FREE
- May be used with a translated ddname, to free a file allocated to an individual subtask, or with an untranslated ddname, to free a file allocated to the region.
- CONCAT
- May be used to produce concatenated allocations.
If a DYNAM command does not fit on a single line, you may end a line with a hyphen "-" to indicate that the command is incomplete. MSO will then issue a WTOR to request the next line of the command. Each line of the command except the final line is ended with a hyphen.
- RESTART CONSOLE
- Reattaches the MSO Console subtask. If the console was running, it terminates the current task and starts a new one. It is normally used to restart the MSO Console following an abend.
- CHAP TCB
- Changes the specified subtasks' MRM priority group. n must be 0 through 15. 15 is the highest priority, and 1 is the lowest. If 0 is specified, the subtask will be suspended.
- SHUTDOWN
- Quiesces all services, and sets MSO to watch for the user count to reach zero. When all users are logged off, MSO will terminate.
- NOW
- Is equivalent to a STOP command.
- CANCEL
- Undoes a pending SHUTDOWN.
- START
- Starts the specified server task. START is not required during normal MSO usage.
- IDLELIM
- Sets the idlelimit value for the region as a whole, overriding the value specified in the MSO configuration file.
- TRACE
- Allows activating and managing of the various traces which Information Builders products and options may generate. Specific information on traces to be generated are provided by Information Builders support personnel.
- trace_name
- Is the name of the trace. Wildcards using * and ? may be used.
- START
- Starts the specified trace(s).
- STOP
- Stops the specified trace(s).
- level
- Specifies the level of the trace. This is dependent on the specific trace that is being used.
- ACTive
- Specifies that this command is to operate with currently active traces.
- DEFer
- Specifies that this command is to be operated with traces that are not yet active.
- SERVICE
- Restricts the scope of the trace command, by screening on any combination of service name, security ID, and TCB address. Wildcards using * and ? may be specified. The default for all three keywords is *. TCB is ignored for deferred traces.
- COND
- Is only valid with the START option. It defines whether or not the trace is conditional. A conditional trace is only recorded if the appropriate ddname for the trace is already allocated; MSO's trace services do not dynamically allocate the trace file for a conditional trace.
- QUERY
- Displays information about the trace(s).
- FULL
- Displays all options used with QUERY.
- SHORT
- Displays a summary view of the options used with QUERY.