Escolar Documentos
Profissional Documentos
Cultura Documentos
Student Guide
OPR101
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
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
DPEC, Inc.
A1
Secondary consoles
Alternate consoles
Hardware consoles
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
Consoles cannot be used for any other input/output purposes (such as TSO, CICS, etc.).
Operator
>
Console
>
MVS
DPEC, Inc.
A1
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
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).
DPEC, Inc.
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
Secondary consoles are additional consoles used for specific types of operator-system communication
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
DPEC, Inc.
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
-------------- 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.
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
DPEC, Inc.
A1
Message Area
Instruction Line
DPEC, Inc.
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.
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
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
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
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
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
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
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
CONSOLES--Display Management
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.
CONSOLES--Display Management
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
CONSOLES--Display Management
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.
CONSOLES--Display Management
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
CONSOLES--Display Management
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
IEE163I MODE=RD 6. The K D,F command breaks the status display into frames for scrolling.
24
DPEC, Inc.
CONSOLES--Display Management
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
CONSOLES--Display Management
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.
B1
This objective explains how to display active jobs and users. 1. Activity on an MVS system consists of three types of processing
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)
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
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.
B1
INITS 00024
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
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.
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
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
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 -- 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
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.
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
DPEC, Inc.
35
C1
This unit covers these commands START & MODIFY and STOP & CANCEL In this objective you'll learn to how to
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.
C1
The name of the cataloged procedure that defines the task to be executed
DPEC, Inc.
37
C1
jobname
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.
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
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.
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
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
42
DPEC, Inc.
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
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:
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.
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
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
(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.
D1
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
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.
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.
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
50
DPEC, Inc.
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
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
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
PCAUTH GRS
0003 0007
JOBNAME ASID
DPEC, Inc.
53
D2
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.
D2
DPEC, Inc.
55
D2
56
DPEC, Inc.
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
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.
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
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.
DPEC, Inc.
59
D2
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.
D2
IOS001E 590,INOPERATIVE PATH 05 The path that has become inoperable The device which has lost the path access
DPEC, Inc.
61
D2
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.
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
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
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.
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
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.
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.