MVS: Basic Operations: Student Guide

MVS: Basic Operations
Student Guide
OPR101
1993 DPEC, Inc.
DPEC, Inc.
This courseware and manual are protected by the U. S. Copyright Law (Title 17 United States Code). Unauthorized reproduction and/or sales may result in imprisonment of up to one year and fines of up to $10,000 (17 USC 505). Copyright infringements may be subject to civil liability up to $50,00 (17 USC 504). Use, duplication or disclosure by the Government is subject to restrictions as set forth in Subparagraph (c) (1) (ii) of the Rights in Technical Data and Computer Software Clause at DFARS 252.227-7013 or FAR 52.227-14. Contractor: DPEC, Inc. 4.99
MVS: BASIC OPERATIONS
Table of Contents
UNIT A CONSOLES Objective #1 Types of Consoles . . . . . . . . . . . . . . . . . . . . . . 1 Objective #2 Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 Objective #3 Display Management . . . . . . . . . . . . . . . . . . . . . 19 UNIT B MONITORING SYSTEM ACTIVITY Objective #1 Displaying System Activity . . . . . . . . . . . . . . . . . Objective #2 Job and Task Termination . . . . . . . . . . . . . . . . . . UNIT C JOB AND TASK MANAGEMENT Objective #1 START & MODIFY Commands . . . . . . . . . . . . . . . . . . Objective #2 STOP & CANCEL Commands . . . . . . . . . . . . . . . . . . . UNIT D DEVICE MANAGEMENT Objective #1 D M, VARY and D U Commands . . . . . . . . . . . . . . . . . Objective #2 Problem Resolution . . . . . . . . . . . . . . . . . . . . . UNIT E BROADCAST MESSAGES Objective #1 SEND & LOG Commands . . . . . . . . . . . . . . . . . . . . 27 32 36 40 44 54 63 66
UNIT F PF KEY ASSIGNMENTS Objective #1 Displaying and Setting . . . . . . . . . . . . . . . . . . .
MVS is a product and/or trademark of IBM Corp.
DPEC, Inc.
CONSOLES Type of Consoles

This unit describes the types of consoles and the console screen format. It also covers system messages, message deletion, and console display and management. This objective introduces
A1
the Master console
Secondary consoles
Alternate consoles
Hardware consoles
the console screen format
1. MVS is an operating system. That is, MVS is an integrated set of computer programs used to manage the computing hardware and control execution of other programs. MVS is responsible for

Program scheduling Resource allocation Input/output control Data management Other related services
2. Computer operators are responsible for monitoring and managing the operations of MVS. 3. Computer operators use consoles to

Issue system commands Receive system messages
Consoles cannot be used for any other input/output purposes (such as TSO, CICS, etc.).
Operator
>
Console
>
MVS
DPEC, Inc.
CONSOLES Types of Consoles

MVS sends messages via the console that
A1
Inform you of the status of jobs
Request that you perform a required action, such as mounting tapes or cartridges
Operator
<
Console
<
MVS
Consoles provide a communication link between you and MVS, JES2/JES3, VTAM, other system components and application programs. Link Operator < > Console < > MVS JES2/JES3 VTAM Other System Components Application Programs Consoles can be used to

Issue system commands Receive system messages
Consoles cannot be used for any other input/output purposes (such as TSO, CICS, etc.). 4. Multiple consoles may be defined for an MVS system (up to a maximum of 99).

1 master console (required) 0-98 secondary consoles
DPEC, Inc.

The Master Console
A1
Is the only console you may use to -- Enter all operator commands -- Change the status of the hard copy log -- Switch to a new master console
Must always be active
Secondary consoles are additional consoles used for specific types of operator-system communication
Network control center
Tape library
Printer area
Secondary consoles
cannot enter all operator commands (but can enter a subset of operator commands) can only receive the messages specifically routed to them may be defined to operate in different operating modes -- Full capability: Receives messages and issues commands -- Message stream: Receives messages only
5. Each console (either master or secondary) may designate an alternate backup console. A designated alternate console receives the messages that are normally routed to a console that has failed. Alternate > Master Console Secondary Console (Tape Pool) Alternate < Alternate
> Secondary Console (Print Pool)
DPEC, Inc.

6. The system console is a non-MVS console you use for hardware-related functions. Here are some system console functions:

A1
Requesting an Initial Microcode Load (IML) Requesting an Initial Program Load (IPL) Changing the IPL load address
You cannot use the system console as an MVS operator console. Here is an example of a system console screen. 10 Jul 99 10:59:13 (OPRCTL)
Operator Controls R= RATE CONTROL -> 1. Process 2. I-Step M= 370 INTERVAL TIMER -> 1. Enable 2. Disable I= IAR 1. Set : ________ D= PCE STALL DETECTION -> 1. Enable 2. Disable O= OPERATOR FUNCTIONS 2. 3. 4. 5. 6. 7. 8. Restart System Reset Load Store Status System Reset Clear Load Clear Sysiml Clear
C= CHECK CONTROL -> 1. Process 2. Hardstop 3. Disable S= TOD CLOCK 1. Enable T= TARGET CP -> 1. CP1 2. CP2 3. CP3 4. CP4
L= LOAD 1. Unit Addr : 06A4 2. Parm : 99
-------------- SYSTEM INDICATORS ------------Mode: ESA/370 Addr Compare: Inactive COMMAND ==> MVSA 1 .... 2 .... 3 .... 4 .... PSW1 OPERATING
7. The service support console is a non-MVS console the vendor service engineer uses to perform service and maintenance functions. It is physically located inside the processor unit. The service support console is not normally used as an MVS operator console; however, you can define it as an alternate operator console for emergency use.
DPEC, Inc.

8. The console screen is divided into these different areas that are used to display different types of information.

A1
Message area Display area Instruction line Entry area Warning line Operator information area
Here's a description of each area. Area Name Message Area Description Contains system and program messages, and copies of operator commands; the size of area depends on the console device used Contains formatted multiple-line information displays; used by certain commands such as DISPLAY Contains console control messages Used to enter commands, or to reply to messages Contains messages to warn the operator of conditions that could require action, such as MESSAGE WAITING Displays the operational status of the terminal
Display Area
Instruction Line Entry Area Warning Line
Operator Information Area
DPEC, Inc.

Here is an example of a full capability console screen, that is, the console may receive messages and issue commands. It illustrates four of the six different areas on the console screen: message area, instruction line, entry area and warning line. IST093I T08A02E ACTIVE IST093I T08A03I ACTIVE IST093I T08A04E ACTIVE IST461I ACTIVATE FOR U/RNAME ENTRY ID = B01-S IST020I VTAM INITIALIZATION COMPLETE IST440I TIME = 14544335 DATE = 1999055 IST441I DLRMAX = 1 CHWR = 3573 IST442I ATTN = 3868 RDATN = 0 IST443I OPIU = 3893 RDBUF = 3000 s tso STC00028 $HASP100 TSO ON STCINRDR - STC00028 $HASP373 TSO STARTED STC00028 IEF403I TSO - STARTED STC00028 IKT007I TCAS ACCEPTING LOGONS STC00028 IKJ019I TIME SHARING IS INITIALIZED 02u IEE600I REPLY TO 02 IS; U START RMF MONITOR III SESSION III TSU00029 $HASP100 APP003 ON TSOINRDR - TSU00029 $HASP373 APP003 STARTED IEE612I CN=MASTER DEVNUM=0FE SYS=SYSTEM1 CMDSYS=SYSTEM1 IEE163I MODE=RD < STC00011 STC00011 STC00011 STC00011 STC00011 STC00011 STC00011 STC00011 STC00011
A1
Message Area
< Entry Area Warning Line
Instruction Line
DPEC, Inc.

Here is an example of a message stream console screen, that is, the console receives messages only. It illustrates the message area and the warning line. IST093I T08A02E ACTIVE IST093I T08A03I ACTIVE IST093I T08A04E ACTIVE IST461I ACTIVATE FOR U/RNAME ENTRY ID = B01-S IST020I VTAM INITIALIZATION COMPLETE IST440I TIME = 14544335 DATE = 1999055 IST441I DLRMAX = 1 CHWR = 3573 IST442I ATTN = 3868 RDATN = 0 IST443I OPIU = 3893 RDBUF = 3000 $HASP100 TSO ON STCINRDR $HASP373 TSO STARTED IEF403I TSO - STARTED IKT007I TCAS ACCEPTING LOGONS IKJ019I TIME SHARING IS INITIALIZED IEE600I REPLY TO 02 IS; U START RMF MONITOR III SESSION III TSU00029 $HASP100 APP003 ON TSOINRDR - TSU00029 $HASP373 APP003 STARTED TSU00030 $HASP100 SYS150 ON TSOINRDR - TSU00030 $HASP373 SYS150 STARTED TSU00031 $HASP100 APP111 ON TSOINRDR - TSU00031 $HASP373 APP111 STARTED TSU00032 $HASP100 SYS122 ON TSOINRDR IEE163I MODE=RD < STC00011 STC00011 STC00011 STC00011 STC00011 STC00011 STC00011 STC00011 STC00011 STC00028 - STC00028 STC00028 STC00028 STC00028
A1
Message Area
Warning Line
DPEC, Inc.
A2
CONSOLES--Messages
In the last objective you saw that a console screen has a message area that contains system and program messages and copies of operator commands. In this objective you'll be looking at
system messages -- message format -- action messages -- outstanding replies -- informational messages message deletion This course doesn't present all possible command options. Check the latest version of MVS manuals for a complete syntax.
NOTE:
You'll start coding MVS commands in this objective, specifically commands to modify message deletion parameters and to perform manual message deletion. Therefore, you need to know the rules for coding commands and the command format. Let's go over the rules. 1. The course uses the following conventions whenever you see command syntax: Notation Upper case Lower case Brackets <> Meaning Enter exactly as shown. Substitute a value. Optional parameter: enter one or none. Choose one parameter from a group. Repeat the parameter any number of times. Enter as shown. Enter as shown. () Enter as shown.
Stacked items Ellipsis ... '
Apostrophes Comma ,
Parentheses
DPEC, Inc.
CONSOLES--Messages
As an example of syntax conventions, look at the syntax for the DISPLAY command below. The upper-case letters must appear exactly as indicated. name is in lower case because you supply the substituted value. ,L ,ALL and ,name are in brackets because they are optional parameters. J, TS and A are stacked items, so code only one from the group. Commas are required to separate the parameters, as shown. D J <,L> TS<,ALL> A <,name> For example, in order to display a detailed list of all active jobs and started tasks, you enter D J,L Here are the spacing rules for the MVS command format COMMAND <parameter<,parameter>...>
A2
blanks are optional
1 or more blanks
1 or more blanks
Always be sure you have at least one blank separating the command from its parameters. Here are some examples of MVS commands you'll see in this objective R 03,U K S,REF K E,SEG
Now let's look at the format of messages MVS sends via the console.
DPEC, Inc.
A2
2. Messages have two parts

CONSOLES--Messages
The message text provides information or describes an error. The message ID normally consists of a prefix, a serial number and a code. 590,INT REQ,D2,0200,,,SYS122A The message text provides information or describes an error.
IEA000I
The message ID normally consists of a ---prefix serial number code
Let's examine each part of the message ID. The message ID normally consists of IEA000I A prefix you use to identify the system component issuing the message. Standard prefixes include IEx IST IGD $HASP IAT IEA000I A serial number to identify the individual message MVS messages VTAM messages SMS messages JES2 messages JES3 messages
10
DPEC, Inc.
CONSOLES--Messages
IEA000I A code to indicate the type of message. Valid options are A D E I W An operator action is required An operator decision is required Eventual operator action is required Informational message; no action required Processing is stopped until you perform an action
A2
Some messages require action on your part (reply to the message or mount a tape, etc.). 3. Action messages are Highlighted and become non-deletable Prefixed with a symbol (* or @) that indicates an operator action is expected Examples *IEF233A M 580,323947,,SYS122A,STEP01,SYS122.DATA
The * indicates that it is a system-issued message that requires operator action. @02 ERB306D III: REPLY WITH OPTIONS OR GO The @ indicates that it is a message from a program that requires operator action. 4. An action message prefixed with a two digit number is considered an outstanding reply, and you must respond. Here's an example of an outstanding reply: *95IEF238D TF08QCPY - REPLY DEVICE NAME,'WAIT' OR 'CANCEL'
DPEC, Inc.
11
A2
Here's the format of the REPLY command.
CONSOLES--Messages
Function To respond to system requests for information Syntax <R> id<,text> Description R Indicates a message reply; if JES2 or JES3 is active, the R is not required id text The two digit reply number from the message that requires an operator reply The response to the message
Examples R 03,U is equivalent to 03,U R 05,90040 is equivalent to 05,90040 After you perform the required action

the action character is replaced with a the message highlighting is eliminated the message becomes deletable
Example IEF233A M 580,323947,,SYS122A,STEP01,SYS122.DATA
12
DPEC, Inc.
CONSOLES--Messages
Here are sample console messages. @01 $HASP426 SPECIFY OPTIONS - JES2 SP 3.1.3 IEF403I RMF - STARTED r 01,u IEE600I REPLY TO 01 IS; U $HASP493 JES2 SYSTEM-ADM QUICK START IS IN PROGRESS s rmf ERB100I ZZ: ACTIVE * STC00011 @02 ERB306D III: REPLY WITH OPTIONS OR GO IEE041I THE SYSTEM LOG IS NOW ACTIVE s net STC00027 $HASP100 NET ON STCINRDR - STC00027 $HASP373 NET STARTED STC00027 IEF403I NET - STARTED s tso STC00028 $HASP100 TSO ON STCINRDR - STC00028 $HASP373 TSO STARTED STC00028 IEF403I TSO - STARTED STC00028 IKT007I TCAS ACCEPTING LOGONS STC00028 IKJ019I TIME SHARING IS INITIALIZED TSU00029 $HASP100 SYS122 ON STCINRDR IEE612I CN=MASTER DEVNUM=0FE SYS=SYSTEM1 CMDSYS=SYSTEM1 IEE163I MODE=RD 5. Informational messages do not require you to act. Are considered deletable messages May be prefixed with a symbol (- or +) Examples - $HASP373 NET STARTED STC00010 STC00011
A2
The - indicates that it is a system-issued message that does not require operator action. + RIM010 - SALES UPDATE COMPLETE The + indicates that it is a message from a program that does not require operator action. If the message is not prefixed by any of the indicator codes (* @ - + ), you are not required to act. Messages remain on the console until they are deleted.
DPEC, Inc.
13
A2
CONSOLES--Messages
6. Messages may be deleted Manually via a console command Automatically by setting the console in roll or roll-deletable mode If additional messages are pending for a console, a warning message is displayed, as shown below.
IST093I T08A02E ACTIVE IST093I T08A03I ACTIVE IST093I T08A04E ACTIVE IST461I ACTIVATE FOR U/RNAME ENTRY ID = B01-S STARTED IST020I VTAM INITIALIZATION COMPLETE IST440I TIME = 14544335 DATE = 1999055 ID = PF01 769 IST441I DLRMAX = 1 CHWR = 3573 CHRD = 3000 IST442I ATTN = 3868 RDATN = 0 IPIU = 3000 IST443I OPIU = 3893 RDBUF = 3000 SLODN = 0 s tso STC00028 $HASP100 TSO ON STCINRDR - STC00028 $HASP373 TSO STARTED STC00028 IEF403I TSO - STARTED STC00028 IKT007I TCAS ACCEPTING LOGONS STC00028 IKJ019I TIME SHARING IS INITIALIZED 02u IEE600I REPLY TO 02 IS; U START RMF MONITOR III SESSION III TSU00029 $HASP100 APP003 ON TSOINRDR - TSU00029 $HASP373 APP003 STARTED IEE612I CN=MASTER DEVNUM=0FE SYS=SYSTEM1 CMDSYS=SYSTEM1 IEE161I WARNING-CON=N DEL=Y IEF159E MESSAGE WAITING
STC00011 STC00011 STC00011 STC00011 STC00011 STC00011 STC00011 STC00011 STC00011
7. The K S,REF command displays the current message deletion parameters. Syntax K S,REF Output The current message deletion parameters are displayed in the entry area for easy modification and re-entry.
14
DPEC, Inc.
CONSOLES--Messages
Example Following is a sample message that appears at the bottom of the console screen after you issue the K S,REF command.
A2
IST093I T08A02E ACTIVE IST093I T08A03I ACTIVE IST093I T08A04E ACTIVE IST461I ACTIVATE FOR U/RNAME ENTRY ID = B01-S STARTED IST020I VTAM INITIALIZATION COMPLETE IST440I TIME = 14544335 DATE = 1999055 ID = PF01 769 IST441I DLRMAX = 1 CHWR = 3573 CHRD = 3000 IST442I ATTN = 3868 RDATN = 0 IPIU = 3000 IST443I OPIU = 3893 RDBUF = 3000 SLODN = 0 s tso STC00028 $HASP100 TSO ON STCINRDR - STC00028 $HASP373 TSO STARTED STC00028 IEF403I TSO - STARTED STC00028 IKT007I TCAS ACCEPTING LOGONS STC00028 IKJ019I TIME SHARING IS INITIALIZED 02u IEE600I REPLY TO 02 IS; U START RMF MONITOR III SESSION III TSU00029 $HASP100 APP003 ON TSOINRDR - TSU00029 $HASP373 APP003 STARTED IEE150I CHANGE OPTIONS IF DESIRED K S,DEL=N,SEG=16,CON=N,RNUM=16,RTME=005,MFORM=(J,M) IEE163I MODE=N IEF159E MESSAGE WAITING
8. To modify the message deletion parameters use a form of the K S command. The syntax is K S<,DEL=m><,SEG=ss><,CON=c><,RNUM=nn><,RTME=ttt><,MFORM=(msg)> Description m The message deletion mode to use when additional messages are waiting for display. Valid options are RD R Y N W Roll-deletable mode; all non-action messages are deleted at a specified interval; action messages will remain at the top of the screen Roll mode; a specified number of messages are deleted at specified intervals Automatic; remove all flagged messages Manual; remove all messages manually Wrap mode; next message overlays the message at the top of the screen
DPEC, Inc.
15
A2
ss c The number of lines to delete when you issue a K E,SEG command Specifies whether manual message deletes are processed in conversational or nonconversational mode. Valid options are Y N nn ttt The operator is prompted to verify the delete request The delete request is processed without operator verification
CONSOLES--Messages
The number of messages that are deleted when the console is in roll or roll-deletable mode The time interval in seconds (1 - 999) between message deletes when the console is in roll or roll-deletable mode The format of each message. T J M S X Valid options are
msg
Display the message with a time stamp Display the message with the issuing job's job number Display the message text only; the message appears whether or not M is coded. Display name of system that sent the message Used with J or S to exempt display of job name or system name for flagged messages
Multiple values may be specified, separated by commas. Below you see an example of the K S command and how you interpret it. The console is placed in roll-deletable mode (DEL=RD), with non-action messages being deleted at a rate of ten messages (RNUM=10) every three seconds (RTME=3). Manual message delete requests will delete a maximum of 16 messages (SEG=16), and will be processed without requiring you to verify (CON=N). Messages will display with the job number of the job that issued the message (MFORM=J). K S,DEL=RD,SEG=16,CON=N,RNUM=10,RTME=3,MFORM=J
16
DPEC, Inc.
CONSOLES--Messages
9. To manually delete messages or to delete non-deletable messages from the console, use a form of the K E command. The syntax is K E<,SEG> <,N> <,nn>(single message) or <,nn,nn>(multiple messages) Description SEG N nn All deletable messages in the message segment are to be deleted (DEFAULT) Number each message currently displayed on the console The number (nn) or range of numbers (nn,nn) of the messages on the console (from the previous K E,N command) to be deleted Function Deletes all deletable messages in the message segment area of the console. Deletes lines one through six on the console. Puts numbers on each message of the console screen, as the example below demonstrates.
A2
Examples K E,SEG or K E K E,1,6 K E,N
DPEC, Inc.
17
A2
CONSOLES--Messages
This sample screen shows how message numbers appear as a result of the K E, N command.
1 STC00011 IST093I T08A02E ACTIVE 2 STC00011 IST093I T08A03I ACTIVE 3 STC00011 IST093I T08A04E ACTIVE 4 STC00011 IST461I ACTIVATE FOR U/RNAME ENTRY ID = B01-S STARTED 5 STC00011 IST020I VTAM INITIALIZATION COMPLETE 6 STC00011 IST440I TIME = 14544335 DATE = 1999055 ID = PF01 769 7 STC00011 IST441I DLRMAX = 1 CHWR = 3573 CHRD = 3000 8 STC00011 IST442I ATTN = 3868 RDATN = 0 IPIU = 3000 9 STC00011 IST443I OPIU = 3893 RDBUF = 3000 SLODN = 0 10 s tso 11 STC00028 $HASP100 TSO ON STCINRDR 12 - STC00028 $HASP373 TSO STARTED 13 STC00028 IEF403I TSO - STARTED 14 STC00028 IKT007I TCAS ACCEPTING LOGONS 15 STC00028 IKJ019I TIME SHARING IS INITIALIZED 16 02u 17 IEE600I REPLY TO 02 IS; U 18 START RMF MONITOR III SESSION III 19 TSU00029 $HASP100 APP003 ON TSOINRDR 20 - TSU00029 $HASP373 APP003 STARTED IEE612I CN=MASTER DEVNUM=0FE SYS=SYSTEM1 CMDSYS=SYSTEM1 IEE163I MODE=RD You can also delete messages by a "point and shoot" approach.
Position the cursor -- on the * or @ of the action message to delete -- anywhere on the non-action messages to delete
Press ENTER to delete -- the action message -- the non-action message and all non-action messages above it
18
DPEC, Inc.
CONSOLES--Display Management
In this objective you'll cover

A3
Displaying system requests Displaying date and time PA keys Display areas
Using the DISPLAY system command, you can display

outstanding messages requiring operator action the date and time
Let's look at the commands and their syntax. 1. The D R command displays outstanding system requests and/or messages. The syntax is D R<,I> <,R> <,U> <,E> <,CE> <,L> <,M>
Description I Display only immediate action messages (operator replies, etc.) R U E CE L M Display only messages awaiting replies Display only pending mount requests Display only eventual action messages (tape unload messages, etc.) Display only critical eventual action messages Display all action messages and pending mount requests Display all immediate action, eventual action, and critical eventual action messages, and messages awaiting replies
DPEC, Inc.
19
A3
Shown below is your output after issuing the D R,L command. That is, you display all action messages and pending mount requests. d r,l IEE112I 14.27.40 PENDING REQUESTS 519 RM=5 IM=0 CEM=0 EM=0 RU=3 IR=0 NOAMRF ID:R/K T MESSAGE TEXT 97 R *97 IEC701D M 78A,VOLUME TO BE LABELED 009991 95 R *95 IEF238D TF08QCPY - REPLY DEVICE NAME,'WAIT' OR 'CANCEL' 11 R *11 CA-7.004 PLEASE ENTER REQUEST 09 R *09 REPLY WITH REQUEST TO DS40 V1 10 R *10 CA-7.574 ENTER ICOM REQUEST READY UNITS : 784 785 78A RM stands for reply messages and indicates the number of outstanding replies waiting. RU stands for ready units and indicates the number of mount requests waiting. R indicates a message awaiting a reply. READY UNITS indicates the mount request drive numbers. Not all messages require an immediate response. For example, the ICOM REQUEST message below only needs a reply when ICOM is ready to shut down. As an operator, you will be most concerned about messages such as the IEC and IEF messages highlighted below. d r,l IEE112I 14.27.40 PENDING REQUESTS 519 RM=5 IM=0 CEM=0 EM=0 RU=3 IR=0 NOAMRF ID:R/K T MESSAGE TEXT 97 R *97 IEC701D M 78A,VOLUME TO BE LABELED 009991 95 R *95 IEF238D TF08QCPY - REPLY DEVICE NAME,'WAIT' OR 'CANCEL' 11 R *11 CA-7.004 PLEASE ENTER REQUEST 09 R *09 REPLY WITH REQUEST TO DS40 V1 10 R *10 CA-7.574 ENTER ICOM REQUEST READY UNITS: 784 785 78A 2. The D T command displays the local time and date. Syntax D T
20
DPEC, Inc.
Sample Output D T IEE136I LOCAL: TIME=14.31.12 DATE=1999.040 GMT=TIME=19.31.12 DATE=1999.040
A3
Program Access keys are used to perform special functions on the console. 3. The PA1 key causes the last entered command to be redisplayed in the command entry area. PA2 clears the entry area and restores the screen. Status displays are multiple line messages generated as the result of
DISPLAY commands
TRACK commands
CONFIG commands
If a status display is displayed in the console message area, the display may roll off the console screen. A display area is a formatted multiple line area below the console message area that may be used to store status displays. If a status display is displayed in a console display area, the display will not roll off the screen. Let's look at how you use variations of the K command to manipulate the display area and its definition. 4. The K A,REF command displays the current display area definition for a console. Syntax K A,REF
DPEC, Inc.
21
A3
Output The next diagram shows sample output resulting from the K A,REF command.
IST093I T08A02E ACTIVE IST093I T08A03I ACTIVE IST093I T08A04E ACTIVE IST461I ACTIVATE FOR U/RNAME ENTRY ID = B01-S STARTED IST020I VTAM INITIALIZATION COMPLETE IST440I TIME = 14544335 DATE = 1999055 ID = PF01 769 IST441I DLRMAX = 1 CHWR = 3573 CHRD = 3000 IST442I ATTN = 3868 RDATN = 0 IPIU = 3000 IST443I OPIU = 3893 RDBUF = 3000 SLODN = 0 s tso STC00028 $HASP100 TSO ON STCINRDR - STC00028 $HASP373 TSO STARTED STC00028 IEF403I TSO - STARTED STC00028 IKT007I TCAS ACCEPTING LOGONS STC00028 IKJ019I TIME SHARING IS INITIALIZED 02u IEE600I REPLY TO 02 IS; U START RMF MONITOR III SESSION III This is the result of TSU00029 $HASP100 APP003 ON TSOINRDR the K A,REF command. - TSU00029 $HASP373 APP003 STARTED K A,NONE tells you that IEE150I CHANGE OPTIONS IF DESIRED no display areas are K A,NONE currently defined. IEE163I MODE=RD 5. The K A,n command defines a display area for a console. Syntax K A,n Description n The number of lines to be reserved for the display area
22
DPEC, Inc.
Example K A,6 A display area consisting of the bottom six lines of the message area is defined. The lines reserved for the display area remain available for use in the message area until the display area is actually used. STC00011 STC00011 STC00011 STC00011 STC00011 STC00011 STC00011 STC00011 STC00028 - STC00028 STC00028 IST093I T08A03I ACTIVE IST093I T08A04E ACTIVE IST461I ACTIVATE FOR U/RNAME ENTRY ID = B01-S IST020I VTAM INITIALIZATION COMPLETE IST440I TIME = 14544335 DATE = 1999055 IST441I DLRMAX = 1 CHWR = 3573 IST442I ATTN = 3868 RDATN = 0 IST443I OPIU = 3893 RDBUF = 3000 s tso $HASP100 TSO ON STCINRDR $HASP373 TSO STARTED IEF403I TSO - STARTED IEE0928I DISPLAY AREA ID'S FOR CONSOLE 01 ARE A
A3
Message Area
This is an example of a console screen before you reserve a display area. The sample screen on the next page shows the console after you issue a K A,6 command. IEE612I CN=MASTER DEVNUM=0FE SYS=SYSTEM1 CMDSYS=SYSTEM1
IEE163I MODE=RD
DPEC, Inc.
23
A3
STC00011 STC00011 STC00011 STC00011 STC00011 STC00011 STC00011 STC00011 STC00028 - STC00028 STC00028
IST093I T08A03I ACTIVE IST093I T08A04E ACTIVE IST461I ACTIVATE FOR U/RNAME ENTRY ID = B01-S IST020I VTAM INITIALIZATION COMPLETE IST440I TIME = 14544335 DATE = 1999055 IST441I DLRMAX = 1 CHWR = 3573 IST442I ATTN = 3868 RDATN = 0 IST443I OPIU = 3893 RDBUF = 3000 s tso $HASP100 TSO ON STCINRDR $HASP373 TSO STARTED IEF403I TSO - STARTED IEE0928I DISPLAY AREA ID'S FOR CONSOLE 01 ARE A
Message Area
Now reserved for the Display Area IEE612I CN=MASTER DEVNUM=0FE SYS=SYSTEM1 CMDSYS=SYSTEM1
IEE163I MODE=RD IST093I T08A03I ACTIVE IST093I T08A04E ACTIVE IST461I ACTIVATE FOR U/RNAME ENTRY ID = B01-S IST020I VTAM INITIALIZATION COMPLETE IST440I TIME = 14544335 DATE = 1999055 IST441I DLRMAX = 1 CHWR = 3573 IST442I ATTN = 3868 RDATN = 0 IST443I OPIU = 3893 RDBUF = 3000 s tso STC00028 $HASP100 TSO ON STCINRDR - STC00028 $HASP373 TSO STARTED STC00028 IEF403I TSO - STARTED IEE0928I DISPLAY AREA ID'S FOR CONSOLE 01 ARE A d a FRAME 1 F E IEE114I 15.48.26 1999.055 ACTIVITY JOBS M/S TS USERS SYSAS INITS ACTIVE/MAX 00010 00021 00041 00010 00024 00041/000 IEE612I CN=MASTER DEVNUM=0FE SYS=SYSTEM1 CMDSYS=SYSTEM1 STC00011 STC00011 STC00011 STC00011 STC00011 STC00011 STC00011 STC00011
Message Area
When you issue a Display command, the output goes here .
IEE163I MODE=RD 6. The K D,F command breaks the status display into frames for scrolling.
24
DPEC, Inc.
Function In some situations, the output of a status display may be larger than the size of the display area. Syntax K D,F The following diagram shows a console display before scrolling. The diagram after it shows the same display after scrolling. IST093I T08A03I ACTIVE IST093I T08A04E ACTIVE IST461I ACTIVATE FOR U/RNAME ENTRY ID = B01-S IST020I VTAM INITIALIZATION COMPLETE IST440I TIME = 14544335 DATE = 1999055 IST441I DLRMAX = 1 CHWR = 3573 IST442I ATTN = 3868 RDATN = 0 This is frame IST443I OPIU = 3893 RDBUF = 3000 1, displaying s tso six lines. STC00028 $HASP100 TSO ON STCINRDR - STC00028 $HASP373 TSO STARTED STC00028 IEF403I TSO - STARTED IEE0928I DISPLAY AREA ID'S FOR CONSOLE 01 ARE A d a,l FRAME 1 F E IEE114I 15.48.26 1999.055 ACTIVITY JOBS M/S TS USERS SYSAS INITS ACTIVE/MAX Display 00010 00021 00041 00010 00024 00041/000 Area JES2 JES2 IEFPROC NSW S LLA LLA LLA NET NET NET NSW S RMF RMF IEFPROC IEE612I CN=MASTER DEVNUM=0FE SYS=SYSTEM1 CMDSYS=SYSTEM1 k d,f IEE163I MODE=RD STC00011 STC00011 STC00011 STC00011 STC00011 STC00011 STC00011 STC00011
A3
DPEC, Inc.
25
A3
STC00011 STC00011 STC00011 STC00011 STC00011 STC00011 STC00011 STC00011
IST093I T08A03I ACTIVE IST093I T08A04E ACTIVE IST461I ACTIVATE FOR U/RNAME ENTRY ID = B01-S IST020I VTAM INITIALIZATION COMPLETE IST440I TIME = 14544335 DATE = 1999055 IST441I DLRMAX = 1 CHWR = 3573 The message IST442I ATTN = 3868 RDATN = 0 scrolls to IST443I OPIU = 3893 RDBUF = 3000 display frame s tso 2, the second STC00028 $HASP100 TSO ON STCINRDR six lines. - STC00028 $HASP373 TSO STARTED STC00028 IEF403I TSO - STARTED IEE0928I DISPLAY AREA ID'S FOR CONSOLE 01 ARE A d a,l FRAME 2 F E IEE114I 15.48.26 1999.055 ACTIVITY JOBS M/S TS USERS SYSAS INITS ACTIVE/MAX Display 00010 00021 00041 00010 00024 00041/000 Area OMEGAMON OMEGAMON IEFPROC NSW S TSO TSO STEP1 ICOM ICOM ICOM NSW S CA7 CA7 CA7 IEE612I CN=MASTER DEVNUM=0FE SYS=SYSTEM1 CMDSYS=SYSTEM1 IEE163I MODE=RD 7. The K E,D command erases a status display from the console display area. Syntax K E,D The lines of the display area will be borrowed for use by the message area until another status display is requested. 8. The K A,NONE command deletes a display area definition from the console. Syntax K A,NONE Note Before you can delete a display area definition, any status displays stored in the display area definitions must be erased.
26
DPEC, Inc.
MONITORING SYSTEM ACTIVITY--Displaying System Activity

This unit presents the DISPLAY command. JCL errors and ABENDs. It also covers
B1
This objective explains how to display active jobs and users. 1. Activity on an MVS system consists of three types of processing

Batch jobs Started tasks TSO users
Let's look at each of these. A batch job is a set of JCL statements that performs application program processing. Batch jobs
Are submitted by programmers or end users via -- TSO -- Card readers -- Automated job scheduling systems (CA-7)
Execute in a JES2 initiator
A started task is a set of JCL statements that perform system level processing. - JES2 - NET - TSO - Others
The JCL for a started task is stored in a JES2-defined procedure library Started tasks are started by the console operator via a START command The JCL for a started task executes in an MVS address space
DPEC, Inc.
27
B1

You've examined two types of system activity (batch jobs and started tasks). Now move on to the third (TSO Users). TSO(Time Sharing Option) is the online (terminal-based) development tool of MVS that allows users to perform

Program development Data set management Batch job management
Each user that is logged on to TSO is represented in MVS by a special task call a TSU (Time Sharing User) that performs the processing required by the user. The JCL for a TSU (Time Sharing User)

Is stored in a JES2-defined procedure library Begins execution when the TSO logon process has been completed Executes in an MVS address space
Now that you know the three types of system activity on MVS, look at a command which displays the system activity. 2. The DISPLAY command displays the system activity. Its syntax is D J <,L> TS<,ALL> A <,name>
Description J TS A L ALL (or JOBS) Display the number of active batch jobs and started tasks Display the number of active time-sharing users Display the number of active batch jobs, started tasks, and active time-sharing users (or LIST) Display names and detailed information about the selected items (J, TS, or A) Display more detailed information about the selected items than is provided by the LIST option
28
DPEC, Inc.

name Example D A Output The sample screen below shows output resulting from the D A command. d a IEE114I 14.58.27 1999.040 ACTIVITY 342 JOBS M/S TS USERS SYSAS 00013 00021 00008 00010 Display even more detailed information about the named item
B1
INITS 00024
ACTIVE/MAX VTAM 00008/00050
OAS 00000
The number of ... Active batch jobs Batch jobs created by the MOUNT or START command Active TSO users System address spaces Started initiators Active VTAM TSO users/ Maximum VTAM TSO users Total OpenMVS address spaces
IEE612I
CN=MASTER
DEVNUM=0FE
SYS=SYSTEM1
CMDSYS=SYSTEM1
IEE163I MODE=RD DISPLAY ACTIVITY: Display Command Function To display the count and the names of all active batch jobs, started tasks and logged-on TSO users Example D A,L
DPEC, Inc.
29
B1

Output Here's sample output resulting from the D A,L command, i.e. this gives more detail than the D A command.
d a,l IEE114I 14.58.27 1999.040 ACTIVITY 342 JOBS M/S TS USERS SYSAS INITS ACTIVE/MAX VTAM {Count} 00013 00021 00008 00010 00024 00008/00050 VLF VLF VLF NSW S LLA LLA LLA NSW S JES2 JES2 IEFPROC NSW S ACF2 ACF2 IEFPROC NSW S ELD VLF VLF NSW S RMF RMF IEFPROC NSW S Names NET NET NET NSW S ICOM ICOM ICOM1 NSW S of OMEGAMON OMEGAMON IEFPROC NSW S CA7RPT CA7RPT RPTPROC NSW S started EPICLOGC EPICLOGC GO NSW S CADSDISP CADSDISP CAIDC1A NSW S tasks VCSS1 VCSS1 CAVVVCSS NSW S CA7 CA7 CA7 NSW S and TSO TSO STEP1 NSW S IMFTSEXS TA04 IEFPROC NSW S POPR0070 STEP0020 NSW J POPR0170 STEP0020 NSW J batch jobs POPR0270 STEP0020 NSW J CMRSS CMRSS IMFSS NSW J POPR0090 POPR0090 TESTCICS NSW J POPR0290 POPR0290 QACICS NSW J POPR0190 POPR0190 CICS NSW J STRACS STRACS STEP2 NSW J PRIM0955 STEP0100 IN J PRIM0080 STEP0010 IN J TS17TPNI STEP0010 OWT J PBIC0004 STEP0020 IN J TSO TF14DDBT STEP0010 OWT J user SYS122 OWT PGM111 OWT PGM150 IN PGM108 OWT SYS128 OWT IDs SYS107 OWT PGM168 OWT PGM155 IN IEE612I CN=MASTER DEVNUM=0FE SYS=SYSTEM1 CMDSYS=SYSTEM1 IEE163I MODE=RD One line of a typical message can give you this information: iii sss www x where iii sss www x is is is is jobname, e.g. POPR0070 the step currently executing, e.g. STEP0020 the status of the job, e.g. NSW means non-swappable the type of user, e.g. J for job
Another line can give you this information: userid www where userid is the ID of an active TSO user, e.g. SYS122 or PGM111 www is the status, e.g. OWT (swapped out, waiting, not ready to execute) or IN (swapped in) DISPLAY ACTIVITY: Display Command Function To display the most detailed information about a specific job
30
DPEC, Inc.

Syntax D J,name Example D J,SYS122XX Here is the output of the D J,SYS122XX command. features: Note these
B1
CT= Indicates in seconds how much CPU time the job has used, in this case .102 seconds. ET= Indicates in seconds how long (clock time) the job has been executing, in this case 261.676 seconds. d j,sys122xx IEE114I 14.59.35 1999.040 ACTIVITY 891 JOBS M/S TS USERS SYSAS 00010 00021 00041 00010 SYS122XX STEP0050 OUT
INITS ACTIVE/MAX VTAM OAS 00024 00041/00050 00000 J A=0031 PER=NO SMC=000 PGN=001 DMN=001 AFF=NONE CT=000.102S ET=261.676S ADDR SPACE ASTE=024D0C40
DPEC, Inc.
31
B2
MONITORING SYSTEM ACTIVITY--Job and Task Termination

This objective covers two types of job failures

JCL errors ABENDs
and two types of ABENDs. Jobs and started tasks will usually start and finish normally. This usually means that

No unexpected errors were encountered All required processing was successfully completed
For example, below you see the MVS message (IEF) and JES2 messages ($HASP) indicating that the job named SYS122J1 started and ended. This is a normal termination. $HASP373 SYS122J1 STARTED - INIT 6 - CLASS I - SYS MVSA IEF403I SYS122J1 - STARTED : $HASP395 SYS122J1 ENDED In some cases, an unexpected error may cause a job to fail. 1. There are two types of job failures

JCL Errors ABENDs
A JCL error occurs when the JCL provided for a job cannot be executed. 2. JCL errors may be due to

Syntax Errors Allocation Errors The JCL does not meet the syntax required by MVS (i.e. - missing commas, misspelled words, etc.).
Syntax Errors:
32
DPEC, Inc.
B2
Allocation Errors:
The JCL does not contain syntax errors, but logic errors do not permit the JCL to function properly (i.e. - missing SPACE request for a disk data set, etc.).
Below are some sample JCL error messages. In example 1 not even a jobname appears. This indicates an error on the job statement and is a JCL syntax error. In example 2, MVS detected a JCL syntax error in the job so it did not start the job. In example 3, the job attempted to start, so MVS did not detect a syntax error. This is an example of an allocation error. Example 1 Example 2 Example 3 IEF452I JOBFAIL JOB NOT RUN - JCL ERROR
IEF452I SYS122J1 JOB NOT RUN - JCL ERROR $HASP396 SYS122J1 TERMINATED $HASP373 SYS122J1 STARTED - INIT 45 - CLASS E - SYS MVSA IEF453I SYS122J1 - JOB FAILED - JCL ERROR $HASP395 SYS122J1 ENDED
ABEND stands for the AB normal END of a program. When you see ABEND on your display screen, it means a job or started task encountered an error from which it cannot recover. The executing program is ended prematurely with an ABEND code to describe the reason for program termination. 3. Two types of ABENDs may occur

System ABENDs User ABENDs
System ABENDs -- MVS encountered an error during execution of the program from which it cannot recover -- The ABEND code is a 3 digit code (Snnn)
DPEC, Inc.
33
B2

-- Look in your MVS System Codes manual for a detailed description of the codes
User ABENDs -- The program encountered an error from which it cannot recover -- The ABEND code is a 4 digit code (Unnnn) -- The meaning of the codes is unique to each program. The program documentation must be consulted to determine the reason for the ABEND.
Here is an example of ABEND codes found in the console messages for the job. $HASP373 SYS122J1 STARTED - INIT 6 - CLASS I - SYS MVSA IEF403I SYS122J1 - STARTED CSV003I REQUESTED MODULE SBPA030 NOT FOUND CSV028I JOBNAME=SYS122J1 STEPNAME=STEP2 ABEND806-04 IEA989I SLIP TRAP ID=X806 MATCHED IEA995I SYMPTOM DUMP OUTPUT ABEND CODE SYSTEM=806 TIME=13.13.16 SEQ=00049 CPU=0000 ASID=00FB PSW AT TIME OF ERROR 070C1000 81019EF4 ILC 2 INTC 0D NO ACTIVE MODULE FOUND DATA AT PSW 01019EEE - 5610A606 0A0D186D 58D002FC GPR 0-3 00002CA6 00001212 0000DC5C 0000A78D GPR 4-7 00004629 0000EE9B 0000F5F0 0000F1F1 GPR 8-11 0000E102 000028B8 0000A084 000074A7 GPR 12-15 0000DF68 000008E2 00002ABF 00001FD6 END OF SYSTEM DUMP JOB00027 CSV028I JOBNAME=SYS122J1 STEPNAME=STEP2 ABEND806-04 JOB00027 IEF457I SYS122J1 STEP2 STEP - ABEND=S806 U0000 REASON=00000000 $HASP309 INIT 6 INACTIVE ******** C=I - JOB00027 $HASP395 SYS122J1 ENDED IEE612I CN=MASTER DEVNUM=0FE SYS=SYS To find a detailed description of each ABEND code, refer to your System Codes manual. IEE163I MODE=RD - JOB00027 JOB00027 JOB00027 JOB00027 JOB00027 JOB00027
34
DPEC, Inc.

Here is a chart of common ABEND codes. Code 806 106 80A 878 813 122 222 322 522 722 A22 Meaning
B2
The program to be executed could not be found; check the spelling of the program name, and the JOBLIB or STEPLIB specification The REGION size on the JOB or EXEC statement was not large enough The data set name in the JCL does not match the data set name in the tape label The console operator cancelled the job and requested a dump The console operator or the user cancelled the job The job exceeded its TIME limit The system wait time limit was exceeded The job output limit was exceeded The operator cancelled the job with a FORCE command
This example is a console with numerous messages. $HASP100 SYS122J1 ON INTRDR $HASP373 SYS122J1 STARTED - INIT 6 - CLASS I IEF403I SYS122J1 - STARTED $HASP100 PGM108XX ON INTRDR $HASP373 PGM108XX STARTED - INIT 9 - CLASS A IEF453I PGM108XX - JOB FAILED - JCL ERROR $HASP395 PGM108XX ENDED $HASP309 INIT 9 INACTIVE ******** C=A JOB00027 IEF457I SYS122J1 STEP3 STEP - ABEND=S322 U0000 $HASP309 INIT 6 INACTIVE ******** C=I JOB00029 $HASP100 SYS128QR ON INTRDR - JOB00029 $HASP373 SYS128QR STARTED - INIT 5 - CLASS I JOB00029 IEF403I SYS128QR- STARTED JOB00030 $HASP100 PGM111XX ON INTRDR - JOB00030 $HASP373 PGM111XX STARTED - INIT 8 - CLASS A - JOB00029 $HASP395 SYS128QR ENDED JOB00030 IEF403I PGM111XX - STARTED JOB00031 $HASP100 SYS122J2 ON INTRDR $HASP309 INIT 5 INACTIVE ******** C=I JOB00031 IEF452I SYS122J2 JOB NOT RUN - JCL ERROR IEE612I CN=MASTER DEVNUM=0FE SYS=SYSTEM1 CMDSYS=SYSTEM1 IEE163I MODE=RD JOB00027 - JOB00027 JOB00027 JOB00028 - JOB00028 JOB00028 JOB00028 SYS MVSA SYS MVSA
REASON=00000000 SYS MVSA SYS MVSA
DPEC, Inc.
35
C1
JOB AND TASK MANAGEMENT--START & MODIFY Commands

In addition to monitoring system activity, you may be required to perform job and task management functions. Required Activity Starting tasks Specifying parameters to control job or task execution Stopping jobs or tasks Cancelling jobs or tasks MVS Command START MODIFY STOP CANCEL or FORCE
This unit covers these commands START & MODIFY and STOP & CANCEL In this objective you'll learn to how to

start a task modify job or task parameters
1. Use the START command to start a system task from the console. The syntax is S procname<,keyword=option> Description procname keyword option The name of the cataloged procedure that defines the task to be executed The name of a symbolic variable in the started task JCL The value to be assigned to the variable
36
DPEC, Inc.

Examples S TSO Start the task from the procedure library with member name TSO. S JES2,MEMBER=JES2ALT Start the task from the procedure library with member name JES2. Parameter MEMBER will have the value JES2ALT. Below is sample output of the START command. s tso $HASP100 TSO ON STCINRDR $HASP373 TSO STARTED IEF403I TSO - STARTED IKT007I TCAS ACCEPTING LOGONS IKJ019I TIME SHARING IS INITIALIZED s badtask $HASP100 BADTASK ON STCINRDR IEF452I BADTASK JOB NOT RUN - JCL ERROR $HASP396 BADTASK TERMINATED IEE122I START COMMAND JCL ERROR The first START command begins the task TSO and time sharing is initialized. The second START command begins task BADTASK, but it is not run due to either a JCL error or because MVS could not locate BADTASK. In some cases, it is necessary to start a task with a name other than the cataloged procedure name. Let's see what form of the START command to use in that case. 2. Use the START command to start a task with a name other than the cataloged procedure name. The syntax is {S procname,JOBNAME=jobname} Description procname
C1
STC00027 - STC00027 STC00027 STC00027 STC00027
The name of the cataloged procedure that defines the task to be executed
DPEC, Inc.
37
C1
jobname

The 1 - 8 character name to be associated with the started task
Example S GTF,JOBNAME=TRACE1 Start the task from the procedure library with member name GTF. Regardless of the internal procedure name, the system will use the name TRACE1 as the identifier for this started task. Now let's look at MODIFY. 3. Use the MODIFY command to specify (or change) parameters for a job or started task via an MVS console. The syntax is F jobname,parameters Description jobname The name of the job or started task that is to have its parameters modified. You can use asterisk notation to specify more than one job or started task. The new or modified parameters
parameters
Example F CICS,CEMT P SHUT The parameter CEMT P SHUT is passed to the job or started task named CICS. Note The parameters specified on a MODIFY command and their syntax are program dependent, and will vary from one program to another.
38
DPEC, Inc.

The parameters will be rejected if the program is not written to allow MODIFY commands. JOB00030 - JOB00030 JOB00030 $HASP100 SYS122JB ON INTRDR $HASP373 SYS122JB STARTED - INIT 6 - CLASS I - SYS MVSA IEF403I SYS122JB - STARTED f sys122jb,hello IEE341I SYS122JB NOT ACTIVE NOT ACTIVE indicates that the program was not written to accept MODIFY command input.
C1
4. Use the MODIFY command to limit the number of TSO users that may log on. The syntax is F TSO,USERMAX=num Description num The maximum number (0 - 32767) of users that may log on to TSO. Specifying USERMAX=0 prevents any additional users from logging on. The following diagram shows the use of the F TSO USERMAX=num command to limit the number of TSO users to 15. 11.48.33 JOBS 00000 11.49.27 JOBS 00000 d ts IEE114I 11.48.33 1999.108 ACTIVITY M/S TS USERS SYSAS INITS 00003 00013 00009 00015 f tso,usermax=15 d ts IEE114I 11.48.33 1999.108 ACTIVITY M/S TS USERS SYSAS INITS 00003 00013 00009 00015
OAS 00000
DPEC, Inc.
39
C2
JOB AND TASK MANAGEMENT--STOP & CANCEL Commands

In the last objective you covered the START and MODIFY commands. In this objective you'll cover

Stopping a job or task Cancelling a job or task Forcing a job or task to terminate Controlling throughput Duplicate jobs Data set enqueues
1. The STOP command stops a job or started task. Its syntax is P jobname Description jobname Example P TSO Stop the task named TSO. The command will be rejected if the program is not written to allow STOP commands. Now let's look at the CANCEL command. 2. The CANCEL command prematurely terminates a job, TSO user or mount request. Its syntax is C jobname<,DUMP><,A=asid><,ARMRESTART U=userid <jobname.>identifier The name of the job or started task to be stopped
40
DPEC, Inc.

Description jobname DUMP asid ARMRESTART userid identifier
C2
The name of the job or started task to be cancelled Generate a dump when the CANCEL command is performed The hexadecimal address space identifier of the work unit to be cancelled Indicates an automatic restart after the cancel completes The logon ID of the TSO user to be cancelled The device number (0000 - FFFF) or device type. Precede a device number with a / to distinguish it from a device type. Cancel the job named SYS122CM. The job will ABEND with system ABEND code 122 and generate a dump. Cancel TSO user TS05. The TSO session will ABEND with system ABEND code 222. Cancel the job with a mount request pending for device number 580. The job will ABEND with system ABEND code 222.
Examples C SYS122CM,DUMP
C U=TS05 C 580
Note When using jobname.identifier, use the identifier specified on the START command. You can also use an asterisk as an identifier to apply the CANCEL to more than one task. Consult a current MVS manual for details on using an asterisk. 3. The FORCE command forces the termination of a job, started task, TSO user or mount request if a CANCEL command fails. Use it as a last resort. Its syntax is FORCE jobname<,ARM><,A=asid><,ARMRESTART U=userid <jobname.>identifier Description jobname ARM
The name of the job or started task to be terminated Required to FORCE jobs or started tasks that are marked as non-cancelable 41
DPEC, Inc.
C2
asid

The hexadecimal address space identifier of the work unit to be cancelled Indicates an automatic restart after the cancel completes
ARMRESTART userid
The logon ID of a TSO user to be terminated The device number (0000 - FFFF) or device type. Precede a device number with a / to distinguish it from a device type.
identifier
Example FORCE RES,ARM Force the started task named RES to ABEND. The task will ABEND with system ABEND code A22. Occasionally, a job is submitted with the same job name as a currently executing job. 4. MVS will not simultaneously execute two jobs with the same job name. These are your alternatives when duplicate job names occur.
Wait for the first job to complete. The second job will then begin processing If it is appropriate, cancel the job that is currently executing
This example shows that a job is already executing with a job name of SYS122T and another job with the same name has been submitted. JOB01836 $HASP301 SYS122T - DUPLICATE JOB NAME - JOB DELAYED
Now let's look at data set enqueues.
42
DPEC, Inc.

5. A data set enqueue results if two executing jobs require the use of the same data set. These are your alternatives in the event of a data set enqueue.
C2
Cancel the job that is currently using the data set(Problem -- how do you know which one it is?) Cancel the job that is waiting to use the data set Wait for the first job to complete its use of the data set -- the second job will then begin processing
For example, job SYS122T below requires data set TEST.ACP.MASTER, but it is currently in use by another job. JOB01836 JOB01836 JOB01836 IEF861I FOLLOWING RESERVED DATA SET NAMES UNAVAILABLE TO SYS122T IEF863I DSN=TEST.ACP.MASTER *IEF099I JOB SYS122T WAITING FOR DATA SETS
DPEC, Inc.
43
D1
DEVICE MANAGEMENT--D M, VARY and D U Commands

This unit covers the D M, VARY and D U commands. It then discusses device management problems and their resolution. This objective will cover these subjects

Hardware architecture Displaying configuration information Placing device paths online or offline Placing I/O devices online or offline Mount requests Displaying device status
Before beginning this objective, let's go over the definition of the following key terms:

device volume data set
TERMINOLOGY: Device Definition The physical device attached to the channel subsystem via a control unit Examples A tape drive or disk drive Device number A three- or four-digit number (0001 - FFFF) used to uniquely identify the device to the channel subsystem TERMINOLOGY: Volume Definition The portion of a storage medium accessible by a single read/write mechanism; data is written on volumes by devices Examples Tape reels, cartridges, or disk packs Volume Serial Number A six character name used to uniquely identify each volume TERMINOLOGY: Data Set Definition A group of related data records; data sets are stored on volumes
44
DPEC, Inc.

Data Set Name A 44 character value used to uniquely identify each data set Example SYS122. TEST.MASTER CPU Channel Subsystem CHPID > 00 01 ... ... ... ... FF HARDWARE ARCHITECTURE
D1
Each storage device (disk, tape, cartridge) is connected to a control unit. Each control unit is connected to the channel subsystem via a channel path. Channel paths are assigned a channel path ID (chpid) from 00 - FF. Multiple paths may be defined for a device as alternate paths. Their use is selected by channel subsystem.
Path
Control Unit
Control Unit
Device
>
Disk Drive
Devices and paths may be online or offline to MVS.
Offline: The device or path is disabled and may not be used Online: The device or path is available for use
1. For MVS to be able to use a device, both the device and a path to the device must be online. Most devices will be set as online as part of the MVS startup process. Operator commands are used to display and alter the online/offline status of devices.
DPEC, Inc.
45
D1

2. The D M=CHP command displays status information about the channel subsystem hardware configuration. Its syntax is D M=CHP(chpid) DEV(dev) Description chpid Display the status of the specified channel paths. This parameter may use any of the following formats: chpid chpid,chpid chpid-chpid A single channel path Multiple channel paths A range of channel paths
(DEFAULT = all channel paths) dev Display the number of online channel paths to the specified device (DEFAULT = all devices) The following example shows the result of the D M=CHP command. Since no channel path is specified, the system displays the status of all channel paths. In this case all channel paths from 00 to FF are online, as indicated by the + signs. d m=chp IEE174I 14.35.33 DISPLAY M 421 CHANNEL PATH STATUS 0 1 2 3 4 5 6 7 8 9 A B C D E F 0 + + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + + 2 + + + + + + + + + + + + + + + + 3 + + + + + + + + + + + + + + + + ************************* SYMBOL EXPLANATIONS *********************** @ ONLINE, PHYSICALLY ONLINE, AND OPERATIONAL INDICATORS ARE NOT EQUAL + ONLINE - OFFLINE . DOES NOT EXIST In the example below, D M=CHP(1) is specified. system displays channel path 01. So, the
12, 13 and 1A are the first two digits of the device number. The third digit is 0 to F across the top. In this instance, for example, device 1A0 is offline, as indicated by the - sign.
46
DPEC, Inc.

d m=chp(1) IEE174I 14.36.38 DISPLAY M 427 CHANNEL PATH 01 STATUS BY DEVICE 0 1 2 3 4 5 6 7 8 9 A B C D 12 + + + + + + + + + + + + + + 13 + + + + + + + + + + + + + + 1A - @ . . . . . . . . . . . . ************************ SYMBOL EXPLANATIONS + ONLINE @ PATH NOT VALIDATED - OFFLINE * PHYSICALLY ONLINE - PATH NOT OPERATIONAL
D1
E F + + + + . . ************************ . DOES NOT EXIST
The example below shows the result of the D M=DEV(120) command. The paths to device 120 via CHPID 01 and 09 are online and operational. d m=dev(120) IEE174I 14.35.29 DISPLAY M 811 DEVICE 120 STATUS=ONLINE CHP 01 09 PATH ONLINE Y Y CHP PHYSICALLY ONLINE Y Y PATH OPERATIONAL Y Y Now let's look at the D M=CONFIG command. 3. The D M=CONFIG command causes MVS to compare the current channel path and device status configuration to a stored configuration. Its syntax is D M=CONFIG(cc) Description cc The suffix of member CONFIGcc in SYS1.PARMLIB that contains the model configuration (DEFAULT = 00) Any differences between the configurations are displayed. Next is sample output in response to a D M=CONFIG command. The command compares the current channel path configuration to the configuration stored in member CONFIG00 of SYS1.PARMLIB.
DPEC, Inc.
47
D1

In this example, MVS did not find any deviations from the desired hardware status configuration. d m=config IEE097I 14.35.33 DEVIATION STATUS 421 NO DEVIATION FROM REQUESTED CONFIGURATION Below is sample output of the D M=CONFIG(01) command. MVS found that device 362 is offline, and DASD volume TEST99 is not mounted. Both conditions are at odds with the desired hardware status configuration stored in member CONFIG01 of SYS1.PARMLIB. d m=config(01) IEE097I 14.48.18 DEVIATION STATUS 640 DEVICE DESIRED ACTUAL 362 ONLINE OFFLINE VOLUME DESIRED ACTUAL TEST99 XXX NOT MNTD 4. The V PATH command places path(s) in online or offline status. Its syntax is V PATH(dev,chpid),ONLINE ,OFFLINE Description dev The number of the device (0000 - FFFF) whose paths are to be placed online or offline. This parameter may use any of the following formats: dev dev,dev dev-dev chpid A single device Multiple devices A range of devices
The channel path ID (00 - FF) associated with the path to be placed online
Examples V PATH(580,5),OFFLINE
The path to device number 580 through channel path 5 should be placed offline.
48
DPEC, Inc.

V PATH(120-127,1),ONLINE The paths to device numbers 120, 121, 122, 123, 124, 125, 126 and 127 through channel path 1 should be placed online.
D1
Now let's learn how to place a device either online or offline. 5. The V dev command places I/O device(s) in online or offline status. Its syntax is V dev,ONLINE ,OFFLINE Description dev
The number of the device (0000 - FFFF) to be placed online or offline. This parameter may use any of the following formats: dev (dev,dev) (dev-dev) A single device Multiple devices A range of devices
ONLINE OFFLINE
Make the device available for use Make the device unavailable for use Places device number 580 offline. Places device numbers 120 - 127 online.
Examples V 580,OFFLINE V (120-127),ONLINE
In this sample output of the VARY command, Device 270 is varied online, then device 44F is varied offline. The vary online operation is performed immediately, but the vary offline request causes MVS to send the message PENDING OFFLINE. It remains in pending status until any task or job has started or stopped. DEALLOC is an example of a dummy task that you can use to complete processing of the vary offline command. v 270,online IEE302I 270 ONLINE v 44F,offline IEE794I 44F PENDING OFFLINE s dealloc IEF403I DEALLOC - STARTED IEE303I 44F OFFLINE IEF404I DEALLOC - ENDED
STC00010 STC00010
DPEC, Inc.
49
D1

If you receive this message: IEE025I UNIT ddd HAS NO LOGICAL PATHS you must also vary a path online for the device. 6. When a job needs to read or write a tape, MVS will allocate (reserve) an unused online tape drive, and issue a mount request to the operator. Here is an MVS message which includes a mount request (M). *IEC501A M 580,PRIVAT,SL,6250 BPI,SYS122T,SYS122.TEST.DATA Indicates a mount request The device is identified with its three digit code (001-FFF). PRIVAT tells the operator to mount any scratch (unused) volume. This is the device on which to mount the volume *IEC501A M 580,PRIVAT,SL,6250 BPI,SYS122T,SYS122.TEST.DATA This is either the serial number of the volume to mount or SCRTCH or PRIVAT: Mount any scratch (unused) volume Following are two examples of mount requests. In the first, you should mount volume number 593201 on cartridge drive number 583. In the second, you should mount any scratch volume on tape drive number 6A0. Example 1 *IEC501A M 583,593201,SL,38K,APP102,TEST.GENL.MASTER Example 2 *IEC501A M 6A0,PRIVAT,SL,6250 BPI,SYS122T,SYS122.TEST.DATA
50
DPEC, Inc.

Confirmation After the correct tape is mounted, MVS will respond with a confirming message. For example, in this confirming message IEC705I TAPE ON 580 ,123456,SL,6250 BPI,SYS122T TAPE ON confirms that tape 123456 is mounted on device 580. Unload After the use of the tape by the program is complete, the tape will automatically rewind, and the console will receive an unload message. IEC502E K 580,123456,,SYS122T The unload message tells you that the volume may now be removed from the drive and returned to the storage rack. Now let's learn about how to display the status of input/output devices. 7. The D U command displays the status of an I/O device. Its syntax is D U<,type><,ONLINE><,dev><,num> <,OFFLINE> <,ALLOC> Description type The type of devices to be displayed. options are DASD TAPE UR TP GRAPHIC CTC ALL ONLINE OFFLINE ALLOC Valid
D1
Disk drives Tape/cartridge drives Unit record devices (Printers, card readers, etc.) Communications equipment Graphic devices channel-to-channel adapters All of the above devices (DEFAULT)
Display the information only for online devices Display the information only for offline devices Display the information only for the devices that are currently in use by a job or started task (DEFAULT = ONLINE and OFFLINE, but allocation information will not be displayed)
DPEC, Inc.
51
D1
dev num

The device number (0000 - FFFF) of the first device to be displayed (DEFAULT = 000) The number of devices for which information is to be displayed The DEFAULT for ONLINE or OFFLINE ALLOC is 16 is 8
Examples D U,DASD,,120,4
Display the information for the first four disk devices (online or offline) beginning with device number 120.
Note: Missing parameters must be represented with commas. In the above example, the online/offline/alloc parameter is missing. D U,,ONLINE,580 Display the information for the first 16 online devices beginning with device number 580. Here the type parameter is missing. Display the information for the first 16 online or offline devices beginning with device number 000.
D U
Let's examine sample output of some D U commands. Below is output from the D U,DASD,ONLINE command. Unit identifies the device number. Type identifies the model number of the device. For example, 3380 and 3390 are the two most common types of IBM disk drives. 3420 is an IBM reel to reel tape drive and 3480 and 3490 are common cartridge drives. VOLSER is the volume serial number. STATUS MEANING O Online, but not allocated A Online and allocated NRD Device not ready BSY Device busy MTP Mount pending F or OFFLINE Offline
52
DPEC, Inc.
D1
d u,dasd,online IEE457I 14.32.35 UNIT STATUS 087 UNIT TYPE STATUS VOLSER VOLSTATE UNIT TYPE STATUS VOLSER VOLSTATE 120 3390 O STOR15 STRG/RSDNT 121 3390 A TECH05 PRIV/RSDNT 122 3390 O STOR18 STRG/RSDNT 123 3390 A TSO001 STRG/RSDNT 124 3390 A STOR16 STRG/RSDNT 125 3390 O STOR19 STRG/RSDNT 126 3390 O STOR17 STRG/RSDNT 127 3390 A HDL003 PRIV/RSDNT 130 3390 O STOR20 STRG/RSDNT 131 3390 A JES201 PRIV/RSDNT 132 3390 A JES204 PRIV/RSDNT 133 3390 A SORT01 PUBL/RSDNT 134 3390 O STOR05 STRG/RSDNT 135 3390 O STOR22 STRG/RSDNT 136 3390 A STOR21 STRG/RSDNT 137 3390 A HDL005 PRIV/RSDNT Below is sample output from the D U,TAPE command. d u,tape IEE457I 14.33.15 UNIT TYPE STATUS 780 3480 O 782 3480 O 784 3480 A-NRD 786 3480 A 788 3480 A-BSY 78A 3480 A-MTP
UNIT STATUS 259 VOLSER VOLSTATE PRIV/REMOV PRIV/REMOV 003399 PRIV/REMOV 002542 PRIV/REMOV 008859 PRIV/REMOV 003350 PRIV/REMOV
UNIT 781 783 785 787 789 78B
TYPE 3480 3480 3480 3480 3480 3480
STATUS VOLSER O O A 002987 A 003231 A-MTP 001263 OFFLINE
VOLSTATE PRIV/REMOV PRIV/REMOV PRIV/REMOV PRIV/REMOV PRIV/REMOV PRIV/REMOV
Below is output from the DU,DASD,ALLOC and the D U,TAPE,ALLOC commands. Note that MVS gives you the name of each job currently using each device. Five disk drives are currently in use by twelve jobs. For example, unit 120 is in use by two jobs, CONSOLE and CALC2. Jobs can never share tape drives. use by the job DITTO1. Tape drive unit 270 is in
d u,dasd,alloc IEE106I 11.33.17 UNITS ALLOCATED 261 UNIT JOBNAME ASID JOBNAME ASID 120 CONSOLE 0008 CALC2 0022 125 NET 0021 130 RMF 000D 134 LLA 000C *MASTER* 0001 135 ALLOCAS 0004 DUMPSRV 0005 d u,tape,alloc IEE106I 11.32.56 UNITS ALLOCATED UNIT JOBNAME ASID JOBNAME ASID 270 DITTO1 0026
JOBNAME
ASID
JOBNAME ASID
CATALOG 0002 TRACE 0006 JOBNAME ASID
PCAUTH GRS
0003 0007
JOBNAME ASID
DPEC, Inc.
53
D2
DEVICE MANAGEMENT--Problem Resolution

This objective deals with device management problems and their resolution, including these topics

Pending allocations Volume enqueues Swapping a volume Device intervention Device checks Changing device mount attributes Path problems
1. Pending Allocations: In certain situations, the tape or cartridge requirements of a job may be impossible for MVS to fulfill. Example A job requires two tape drives; however, only one drive is available. The rest are in use by other jobs. The example below shows how MVS notifies you of the shortage of available units. MVS tells you automatically which units are offline, then, via an action message, asks you to answer with a device name, wait or cancel. (The device name is actually the device number.) However, you do not know the type of device required. IEF244I IEF247I *23IEF238D SYS122T STEP01 - UNABLE TO ALLOCATE 01 UNITS AT LEAST 01 OFFLINE UNITS NEEDED SYS122T 586, 587 OFFLINE SYS122T REPLY DEVICE NAME, 'WAIT' OR 'CANCEL'
Let's see how you can respond. Resolution: Step 1 To verify the type of device the system is requesting issue the D U,TAPE,OFFLINE command. In the example below the system's response shows that the offline drives 586 and 587 are type 3480.
54
DPEC, Inc.

SYS122T STEP01 - UNABLE TO ALLOCATE 01 UNITS AT LEAST 01 OFFLINE UNITS NEEDED IEF247I SYS122T 586, 587 OFFLINE *23IEF238D SYS122T REPLY DEVICE NAME, 'WAIT' OR 'CANCEL' d u,tape,offline IEE457I 14.33.15 UNIT STATUS 259 UNIT TYPE UNIT TYPE 586 3480 587 3480 Resolution: Step 2 If you want to use device 586 reply to the message with the device number. You use the <R> id<,text> command you learned earlier, where id is the message id and text is your response. For the example below, issue the command R 23,586 which tells MVS that you want to continue processing using drive 586. SYS122T STEP01 - UNABLE TO ALLOCATE 01 UNITS AT LEAST 01 OFFLINE UNITS NEEDED IEF247I SYS122T 586, 587 OFFLINE *23IEF238D SYS122T REPLY DEVICE NAME, 'WAIT' OR 'CANCEL' d u,tape,offline IEE457I 14.33.15 UNIT STATUS 259 UNIT TYPE UNIT TYPE 586 3480 587 3480 r 23,586 If no drives are available, you can instruct MVS to have the job wait until other drives become available. In the example below, you issue the command R 23,WAIT requesting MVS to have the job wait until another drive is available. MVS asks you to reply with either HOLD or NOHOLD. SYS122T STEP01 - UNABLE TO ALLOCATE 01 UNITS AT LEAST 01 OFFLINE UNITS NEEDED IEF247I SYS122T 586, 587 OFFLINE *23IEF238D SYS122T REPLY DEVICE NAME, 'WAIT' OR 'CANCEL' r 23,wait *24IEF433D SYS122T WAIT REQUESTED -- REPLY 'HOLD' OR 'NOHOLD' If you want the job to hold all its allocated drives until the remaining drives become available, reply HOLD. In this case R 24,HOLD is the command to use. IEF244I IEF244I IEF244I
D2
DPEC, Inc.
55
D2

If the job should release all its allocated drives until the remaining drives become available, use the same syntax with NOHOLD. SYS122T STEP01 - UNABLE TO ALLOCATE 01 UNITS AT LEAST 01 OFFLINE UNITS NEEDED IEF247I SYS122T 586, 587 OFFLINE *23IEF238D SYS122T REPLY DEVICE NAME, 'WAIT' OR 'CANCEL' r 23,wait *24IEF433D SYS122T WAIT REQUESTED -- REPLY 'HOLD' OR 'NOHOLD' r 24,hold Now let's look at volume enqueues. 2. Volume Enqueues: In certain situations, a job may require a tape or cartridge volume that is currently being used by another job. MVS notifies you of the conflict with the message on the next page. The job will now wait until the volume(s) become available (similar to a data set enqueue). Resolution Alternatives 1. Cancel the job that is currently using the volume. 2. Wait for the first job to complete its use of the volume -- the second job will then begin processing. 3. Cancel the job that is waiting to use the data set by replying NO to the IEF235D message. IEF690I IEF690I *37IEF235D FOLLOWING VOLUMES UNAVAILABLE TO SYS122T STEP01 735356 SYS122T STEP01 WAITING FOR VOLUMES, TO CANCEL WAIT REPLY 'NO' IEF244I
Now let's consider how to swap a volume.
56
DPEC, Inc.

3. Use the SWAP command to request that MVS swap a volume from one device to another. The syntax is SWAP from,to Description from The device number (0000 - FFFF) from which the volume is to be swapped to The device number (0000 - FFFF) to which the volume is to be swapped
D2
Say for example that you issue the command below (Step 1) to swap a volume from 680 to 681. You receive the system message shown below. These are your valid responses: r id,YES r id,NO r id,nnn Proceed with the swap as indicated Cancel the swap request Swap the volume to device number nnn, instead of the original device number
where id is the reply number. (25 in the example below.) STEP 1 swap 680,681 IGF500I SWAP 680 TO 681 - OPERATOR *25IGF500D REPLY 'YES', DEVICE OR 'NO' You reply YES (Step 2) and receive the message to proceed. You or your tape pool operator tape or cartridge and loads it installations the load is done does MVS give you the COMPLETE STEP 1 then physically moves the onto device 681. (In some mechanically.) Only then message shown below.
swap 680,681 IGF500I SWAP 680 TO 681 - OPERATOR *25IGF500D REPLY 'YES', DEVICE OR 'NO' STEP 2 r 25,yes IGF502E PROCEED WITH SWAP OF 680 TO 681 IGF505I SWAP FROM 680 TO 681 COMPLETE Now let's look at device intervention messages. 4. Device Intervention: When a device fails or becomes inoperable MVS issues a device intervention message. The message displays the device number of the device requiring operator intervention, in this case 590.
DPEC, Inc.
57
D2

INTervention REQuired means the operator is expected to intervene to correct the problem. IOS003A 590,INTERVENTION REQUIRED or IEA000I 590,INT REQ,D2,0200,,,TEST01 Resolution The response to a device intervention message depends on the type of device requiring intervention. Device Printers Possible problems The printer has run out of paper. A paper jam has occurred. A forms change is required. The tape did not load correctly. The ready button was not pushed. The switches were not set correctly on the disk drive.
Tape Disk
In order to find out what device requires intervention you use a form of the D U command you learned earlier. The syntax is D U,,,dev,num where dev is the device number of the device requiring intervention and num indicates the number of devices to display. For example, you code D U,,,101,1 if you want to check the status of drive number 101. Device or data check messages are similar to device intervention messages, except that a three character code is listed after the device number, as shown below. IOS000I 270,02,DCK,01,0D00,,,078190,384655 or Data Check
IEA000I 270,DCK,01,0D00,,,078190,384655,11.33.31
58
DPEC, Inc.

Here's an example of an equipment check message. The response to a device, data check or equipment check message depends on the type of device that generated the message. IOS000I 275,02,EQC,01,0D00,,,078190,474633 or Equipment Check
D2
IEA000I 275,EQC,01,0D00,,,078190,474633,13.48.11 5. Device Checks: Device check messages are similar to device intervention messages, except that a three character code is listed after the device number. 6. Device Checks -- Tape: The problem may be in either the tape volume or the tape drive. If a problem with the tape drive is suspected

Swap the volume to another drive Request that the read/write heads be cleaned If the problem persists, vary the drive offline
If a problem with the tape volume is suspected

Request that the tape be cleaned (it may be dirty) Swap the tape to the drive on which it was created (if known)
Always log the problem so that follow-up action will be taken. 7. Device Checks -- DASD: Device checks on DASD units usually indicate a hardware problem that must be resolved by the vendor. Resolution Log the problem and notify your supervisor
Do not vary the device offline. Other jobs may be able to access other data sets on the device.
To ensure that no new data sets are stored on the device
Check the status of the drive via a D U command
DPEC, Inc.
59
D2

If the device status is STRG (storage) or PUB (public), it should be changed to PRIV via a MOUNT command
In the example below, you issued the D U,,,120,1 command to check the status of drive 120. Notice that VOLSTATE is STRG. To ensure that no new data sets are stored on drive 120, you change STRG to PRIV (private) via a MOUNT command. d u,,,120,1 IEE457I 14.32.35 UNIT STATUS 087 UNIT TYPE STATUS VOLSER VOLSTATE 120 3390 O STOR15 STRG/RSDNT Now let's learn how to mount a volume. 8. Use the MOUNT command to change the mount attributes of a device or to mount a volume. The syntax is M dev,VOL=(SL,volser),USE=PRIVATE PUBLIC STORAGE Description dev volser PRIVATE PUBLIC STORAGE The device number (0000 - FFFF) of the device to be mounted The 1 - 6 character serial number of the volume to be mounted The volume may only be used by jobs that specifically request the volume (DEFAULT) The volume may be used by any job to create temporary data sets The volume may be used by any job to create permanent data sets
Let's look at an example of how to use the MOUNT command. In this example you issue the command D U,,,6a8,1 to find out the status of device 6a8 in response to a device check message. The PUB code under VOLSTATE indicates that volume PROD09 is available (PUBLIC) to any job to create temporary data sets.
60
DPEC, Inc.

You then issue the MOUNT command to ensure that now only jobs that specifically request volume PROD09 will be able to create data sets on it. After the disk drive is repaired, you would use another MOUNT command to change the mount attribute back to PUBLIC or STORAGE (as required). d u,,,6a8,1 IEE457I 10.35.06 UNIT STATUS UNIT TYPE STATUS VOLSER VOLSTATE 6A8 3380 O PROD09 PUB/RSDNT : m 6a8,vol=(sl,prod09),use=private - STC00026 $HASP395 MOUNT ENDED d u,,,6a8,1 IEE457I 10.35.56 UNIT STATUS UNIT TYPE STATUS VOLSER VOLSTATE 6A8 3380 O PROD09 PRIV/RSDNT : Now let's consider path problems. 9. Path Problems: When a path to a device fails or becomes inoperable, MVS issues a warning message. Resolution Most devices will have alternate paths available. MVS uses the alternate paths until the failing path is made operational. IEA001I UNIT 590, PATH '05', INOPERATIVE FOR CHANNEL SET 0
D2
IOS001E 590,INOPERATIVE PATH 05 The path that has become inoperable The device which has lost the path access
DPEC, Inc.
61
D2

If no alternate paths are available, MVS will issue one of the messages below. IEA000I 590,CC=3/NO PATHS AVAILABLE or IOS002A 590,NO PATHS AVAILABLE Here are some common reasons that a path may fail.

Disabled control unit Altered switching unit Disabled channel path
Your response should be to

Log the problem (including device and path number) Notify your supervisor Verify that the control unit is working and all switches are set properly
62
DPEC, Inc.
BROADCAST MESSAGES--SEND & LOG Commands

This unit covers the SEND and LOG commands, including these topics

E1
sending a message to TSO users broadcast data set messages -- storing -- displaying -- deleting sending a message to MVS consoles storing messages in the system log
Console commands may be used to send messages to

Active TSO users TSO users at logon time Other MVS consoles The system log
1. Use the SEND command to send messages to TSO users. The syntax is SE 'message'<,USER=(userid)><,LOGON><,WAIT> <,ALL> <,NOW> <,NOWAIT> Description message userid The message to be sent to a TSO user The TSO user ID(s) to receive the message; multiple user IDs may be enclosed in parenthesis and separated by commas. Send the message to all TSO users (DEFAULT) Send the message immediately if the specified user is logged on and receiving messages; otherwise, save the message until the next user logon Send the message immediately; if the user is not currently logged on, the message is deleted (DEFAULT) Hold the message until system output buffers are available (DEFAULT)
ALL LOGON
NOW
WAIT
DPEC, Inc.
63
E1
NOWAIT

Do not hold the message
Examples SE 'PLEASE LOGOFF NOW' The message will be sent to all active TSO users. SE 'YOUR JOB HAS BEEN REQUEUED',USER=SYS122 The message will be sent to TSO user SYS122. 2. To store messages in the broadcast data set so that they will display each time any TSO user logs on, use this form of the SEND command SE 'message',SAVE Description message The message to be stored in the broadcast data set
Example SE 'MVS WILL BE DOWN ON SUNDAY FOR TESTING',SAVE The message will be sent to each TSO user when they logon. 3. To list the messages stored in the broadcast data set use this form of the SEND command SE num,LIST Description num The message number of the message to be displayed (DEFAULT = all the stored messages will be displayed) Here is sample output of the SEND LIST command. send list MSGNO 001 ******************************************************* MSGNO 002 *** XYZ CORP. MVS SYSTEM *** MSGNO 003 ******************************************************* MSGNO 004 MVS WILL BE DOWN ON SUNDAY FOR TESTING 4. To delete a message stored in the broadcast data set use this form of the SEND command SE num,DELETE
64
DPEC, Inc.

Description num The message number of the message to be deleted Example SEND 4,DELETE Message number 4 in the broadcast data set will be deleted. 5. To send messages to other MVS consoles use this form of the SEND command SE 'message',BRDCST ,OPERATOR=code ,CN=console Description message BRDCST code console The message to be sent to another console Send the message to all active consoles Send the message only to consoles defined to receive this route code The ID (0 - 99) of the console to receive the message
E1
Examples SE 'SYSTEM SHUTDOWN WILL BEGIN AT 21:30',BRDCST Send the message to all active consoles. SE 'CE CALLED TO FIX DRIVE 580',OPERATOR=5 Send the message to any console receiving route code 5 messages. Now let's look at log messages. 6. To store messages in the system log use the LOG command. The syntax is L 'text' Description text The message to be written in the system log Example L 'DEVICE 120 VARIED OFFLINE FOR MAINTENANCE'
DPEC, Inc.
65
F1
PF KEY ASSIGNMENTS--Displaying and Setting

This unit defines PF keys and explains how to display and modify them. 1. Program function keys are special keyboard keys that can be "programmed" to perform tasks in the place of commands. Pressing a PF key will produce the same result as manually entering the command associated with the key. Default PF key definitions for each console are established during MVS system generation. A console operator may

Display the current PF key assignments Define new commands to be associated with a PF key
2. To display the current PF key assignments use the D PFK command. Syntax D PFK
66
DPEC, Inc.

Let's look at a partial D PFK console screen. d pfk IEE235I 14.30.45 PFK DISPLAY 635 PFK DEFINITIONS FOR CONSOLE 1 - TABLE = MASTCONS IN PFKTAB00 KEY# CON ---------------------DEFINITIONS--------------------1 NO K E,1 2 NO K E : KEY # is the function key number. 5 NO K S,DEL=N 6 NO K S,DEL=RD The CON column designates YES : or NO indicating whether the 10 NO $DA PF key is conversational or 11 NO D U,TAPE,ONLINE non-conversational. 12 NO D U,TAPE,ALLOC : A conversational key displays the 18 YES DD CLEAR,DSN= command and allows you to modify 19 NO D A,L it prior to use. 20 NO D R,L 21 YES V NET,ACT,ID=_ A non-conversational key invokes 22 YES V NET,INACT,ID= the command immediately. 23 NO D U,TAPE,ONLINE 24 NO D U,TAPE,ALLOC d pfk IEE235I 14.30.45 PFK DISPLAY 635 PFK DEFINITIONS FOR CONSOLE 1 - TABLE = MASTCONS IN PFKTAB00 KEY# CON -------------------- DEFINITIONS -------------------1 NO K E,1 2 NO K E : DEFINITIONS indicates the 5 NO K S,DEL=N function each PF key will perform. 6 NO K S,DEL=RD For example, pressing PF11 will : display all tape drives currently 10 NO $DA online by invoking the command 11 NO D U,TAPE,ONLINE 12 NO D U,TAPE,ALLOC D U,TAPE,ONLINE : 18 YES DD CLEAR,DSN= 19 NO D A,L 20 NO D R,L 21 YES V NET,ACT,ID=_ 22 YES V NET,INACT,ID=_ 23 NO D U,TAPE,ONLINE 24 NO D U,TAPE,ALLOC 3. To define or modify a PF key definition use the K N command. The syntax is K N,PFK=(nn,CMD='text')<,CON=mode>
F1
DPEC, Inc.
67
F1
Description nn text
The number of the PF key to be defined The command to be associated with the PF key; multiple commands may be specified if separated by semicolons Specifies whether the PF key is to be used in conversational or non-conversational mode. Valid options are Y The command will be displayed on the command line and the operator may modify it before pressing ENTER The command will be issued immediately when the PF key is pressed (DEFAULT)
mode
Example K N,PFK=(01,CMD='D A,J'),CON=N This defines a command for PF1. When PF1 is pressed, the console will issue a D A,J command. The command will be issued immediately.
68
DPEC, Inc.

MVS: Basic Operations: Student Guide

Загружено:

Сведения о документе

Исходное описание:

Оригинальное название

Авторское право

Доступные форматы

Поделиться этим документом

Поделиться или встроить документ

Параметры публикации

Этот документ был вам полезен?

Это неприемлемый материал?

Авторское право:

Доступные форматы

MVS: Basic Operations: Student Guide

Загружено:

Авторское право:

Доступные форматы

MVS: Basic Operations

1993 DPEC, Inc.

MVS: BASIC OPERATIONS

UNIT F PF KEY ASSIGNMENTS Objective #1 Displaying and Setting . . . . . . . . . . . . . . . . . . .

MVS is a product and/or trademark of IBM Corp.

CONSOLES Type of Consoles

the Master console

the console screen format

Issue system commands Receive system messages

CONSOLES Types of Consoles

Inform you of the status of jobs

Issue system commands Receive system messages

1 master console (required) 0-98 secondary consoles

CONSOLES Type of Consoles

Must always be active

Network control center

> Secondary Console (Print Pool)

CONSOLES Types of Consoles

L= LOAD 1. Unit Addr : 06A4 2. Parm : 99

CONSOLES Type of Consoles

Instruction Line Entry Area Warning Line

Operator Information Area

CONSOLES Types of Consoles

< Entry Area Warning Line

CONSOLES Type of Consoles

Stacked items Ellipsis ... '

blanks are optional

The message ID normally consists of a ---prefix serial number code

Example IEF233A M 580,323947,,SYS122A,STEP01,SYS122.DATA

STC00011 STC00011 STC00011 STC00011 STC00011 STC00011 STC00011 STC00011 STC00011

STC00011 STC00011 STC00011 STC00011 STC00011 STC00011 STC00011 STC00011 STC00011

Examples K E,SEG or K E K E,1,6 K E,N

Using the DISPLAY system command, you can display

outstanding messages requiring operator action the date and time

STC00011 STC00011 STC00011 STC00011 STC00011 STC00011 STC00011 STC00011 STC00011

When you issue a Display command, the output goes here .

MONITORING SYSTEM ACTIVITY--Displaying System Activity

Batch jobs Started tasks TSO users

Execute in a JES2 initiator

MONITORING SYSTEM ACTIVITY--Displaying System Activity

Program development Data set management Batch job management

MONITORING SYSTEM ACTIVITY--Displaying System Activity

ACTIVE/MAX VTAM 00008/00050

MONITORING SYSTEM ACTIVITY--Displaying System Activity

MONITORING SYSTEM ACTIVITY--Displaying System Activity

MONITORING SYSTEM ACTIVITY--Job and Task Termination

JCL errors ABENDs

JCL Errors ABENDs

MONITORING SYSTEM ACTIVITY--Job and Task Termination

System ABENDs User ABENDs

MONITORING SYSTEM ACTIVITY--Job and Task Termination

MONITORING SYSTEM ACTIVITY--Job and Task Termination

REASON=00000000 SYS MVSA SYS MVSA

JOB AND TASK MANAGEMENT--START & MODIFY Commands

start a task modify job or task parameters

JOB AND TASK MANAGEMENT--START & MODIFY Commands

STC00027 - STC00027 STC00027 STC00027 STC00027

JOB AND TASK MANAGEMENT--START & MODIFY Commands

JOB AND TASK MANAGEMENT--START & MODIFY Commands

ACTIVE/MAX VTAM 00013/00050

ACTIVE/MAX VTAM 00013/00015

JOB AND TASK MANAGEMENT--STOP & CANCEL Commands