Basic Mvs Operations

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 UnitedStates Code). Unauthorized reproduction and/or sales may result in imprisonment of upto one year and fines of up to $10,000 (17 USC 505). Copyright infringements may besubject to civil liability up to $50,00 (17 USC 504).

Use, duplication or disclosure by the Government is subject to restrictions as set forth inSubparagraph (c) (1) (ii) of the Rights in Technical Data and Computer Software Clauseat DFARS 252.227-7013 or FAR 52.227-14. Contractor: DPEC, Inc.

4.99

MVS: BASIC OPERATIONS Table of Contents

DPEC, Inc.

UNIT A CONSOLESObjective #1 Types of Consoles . . . . . . . . . . . . . . . . . . . . . . 1Objective #2 Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . 8Objective #3 Display Management . . . . . . . . . . . . . . . . . . . . . 19

UNIT B MONITORING SYSTEM ACTIVITYObjective #1 Displaying System Activity . . . . . . . . . . . . . . . . . 27Objective #2 Job and Task Termination . . . . . . . . . . . . . . . . . . 32

UNIT C JOB AND TASK MANAGEMENTObjective #1 START & MODIFY Commands . . . . . . . . . . . . . . . . . . 36Objective #2 STOP & CANCEL Commands . . . . . . . . . . . . . . . . . . . 40

UNIT D DEVICE MANAGEMENTObjective #1 D M, VARY and D U Commands . . . . . . . . . . . . . . . . . 44Objective #2 Problem Resolution . . . . . . . . . . . . . . . . . . . . . 54

UNIT E BROADCAST MESSAGESObjective #1 SEND & LOG Commands . . . . . . . . . . . . . . . . . . . . 63

UNIT F PF KEY ASSIGNMENTSObjective #1 Displaying and Setting . . . . . . . . . . . . . . . . . . . 66

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

CONSOLES – Type of Consoles A1

DPEC, Inc. 1

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

• 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

CONSOLES – Types of Consoles A1

DPEC, Inc.2

MVS sends messages via the console that

• 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.

MVS Link JES2/JES3 Operator < > Console < > 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. 3

The Master Console

• 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 Alternate > > < Alternate Master Secondary Secondary Console Console Console (Tape Pool) (Print Pool)


DPEC, Inc.4

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

Here are some system console functions:

• 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 Operator Controls (OPRCTL)

R= RATE CONTROL O= OPERATOR FUNCTIONS C= CHECK CONTROL -> 1. Process -> 1. Process 2. I-Step 2. Restart 2. Hardstop 3. System Reset 3. Disable M= 370 INTERVAL TIMER 4. Load -> 1. Enable 5. Store Status S= TOD CLOCK 2. Disable 6. System Reset Clear 1. Enable 7. Load Clear I= IAR 8. Sysiml Clear T= TARGET CP 1. Set : ________ -> 1. CP1 L= LOAD 2. CP2 D= PCE STALL DETECTION 1. Unit Addr : 06A4 3. CP3 -> 1. Enable 2. Parm : 99 4. CP4 2. Disable

-------------- 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. 5

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

• Message area

• Display area

• Instruction line

• Entry area

• Warning line

• Operator information area

Here's a description of each area.

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


DPEC, Inc.6

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.

STC00011 IST093I T08A02E ACTIVE STC00011 IST093I T08A03I ACTIVE STC00011 IST093I T08A04E ACTIVE STC00011 IST461I ACTIVATE FOR U/RNAME ENTRY ID = B01-S STC00011 IST020I VTAM INITIALIZATION COMPLETE STC00011 IST440I TIME = 14544335 DATE = 1999055 STC00011 IST441I DLRMAX = 1 CHWR = 3573 STC00011 IST442I ATTN = 3868 RDATN = 0 STC00011 IST443I OPIU = 3893 RDBUF = 3000 s tso Message STC00028 $HASP100 TSO ON STCINRDR Area - 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 Instruction - TSU00029 $HASP373 APP003 STARTED Line IEE612I CN=MASTER DEVNUM=0FE SYS=SYSTEM1 CMDSYS=SYSTEM1 < Entry Area IEE163I MODE=RD < Warning Line


DPEC, Inc. 7

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.

STC00011 IST093I T08A02E ACTIVE STC00011 IST093I T08A03I ACTIVE STC00011 IST093I T08A04E ACTIVE STC00011 IST461I ACTIVATE FOR U/RNAME ENTRY ID = B01-S STC00011 IST020I VTAM INITIALIZATION COMPLETE STC00011 IST440I TIME = 14544335 DATE = 1999055 STC00011 IST441I DLRMAX = 1 CHWR = 3573 STC00011 IST442I ATTN = 3868 RDATN = 0 STC00011 IST443I OPIU = 3893 RDBUF = 3000 STC00028 $HASP100 TSO ON STCINRDR - STC00028 $HASP373 TSO STARTED Message STC00028 IEF403I TSO - STARTED Area STC00028 IKT007I TCAS ACCEPTING LOGONS STC00028 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 < Warning Line

A2 CONSOLES--Messages

8 DPEC, Inc.

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

NOTE: This course doesn't present all possible command options. Check the latest version of MVS manuals for a complete syntax.

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 Meaning Upper case Enter exactly as shown. Lower case Substitute a value. Brackets <> Optional parameter: enter one or none. Stacked items Choose one parameter from a group. Ellipsis ... Repeat the parameter any number of times. Apostrophes ' Enter as shown. Comma , Enter as shown. Parentheses () Enter as shown.

CONSOLES--Messages A2

DPEC, Inc. 9

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>...>

blanks 1 or 1 or are more more optional blanks 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.


10 DPEC, Inc.

2. Messages have two parts

• The message text provides information or describes an error. • The message ID normally consists of a prefix, a serial number and a code.

IEA000I 590,INT REQ,D2,0200,,,SYS122A The message text provides information or describes an error. 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 MVS messages

IST VTAM messages

IGD SMS messages

$HASP JES2 messages

IAT JES3 messages

IEA000I A serial number to identify the individual message


DPEC, Inc. 11

IEA000I A code to indicate the type of message. Valid options are

A An operator action is required

D An operator decision is required

E Eventual operator action is required

I Informational message; no action required

W Processing is stopped until you perform an action

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'


12 DPEC, Inc.

Here's the format of the REPLY command.

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 The two digit reply number from the message that requires an operator reply

text 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


DPEC, Inc. 13

Here are sample console messages.

STC00010 @01 $HASP426 SPECIFY OPTIONS - JES2 SP 3.1.3 STC00011 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 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.


14 DPEC, Inc.

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.

STC00011 IST093I T08A02E ACTIVE STC00011 IST093I T08A03I ACTIVE STC00011 IST093I T08A04E ACTIVE STC00011 IST461I ACTIVATE FOR U/RNAME ENTRY ID = B01-S STARTED STC00011 IST020I VTAM INITIALIZATION COMPLETE STC00011 IST440I TIME = 14544335 DATE = 1999055 ID = PF01 769 STC00011 IST441I DLRMAX = 1 CHWR = 3573 CHRD = 3000 STC00011 IST442I ATTN = 3868 RDATN = 0 IPIU = 3000 STC00011 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.


DPEC, Inc. 15

Example Following is a sample message that appears at the bottom of the console screen after you issue the K S,REF command.

STC00011 IST093I T08A02E ACTIVE STC00011 IST093I T08A03I ACTIVE STC00011 IST093I T08A04E ACTIVE STC00011 IST461I ACTIVATE FOR U/RNAME ENTRY ID = B01-S STARTED STC00011 IST020I VTAM INITIALIZATION COMPLETE STC00011 IST440I TIME = 14544335 DATE = 1999055 ID = PF01 769 STC00011 IST441I DLRMAX = 1 CHWR = 3573 CHRD = 3000 STC00011 IST442I ATTN = 3868 RDATN = 0 IPIU = 3000 STC00011 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 Roll-deletable mode; all non-action messages are deleted at a specified interval; action messages will remain at the top of the screen R Roll mode; a specified number of messages are deleted at specified intervals Y Automatic; remove all flagged messages N Manual; remove all messages manually W Wrap mode; next message overlays the message at the top of the screen


16 DPEC, Inc.

ss The number of lines to delete when you issue a K E,SEG command

c Specifies whether manual message deletes are processed in conversational or non- conversational mode. Valid options are

Y The operator is prompted to verify the delete request N The delete request is processed without operator verification

nn The number of messages that are deleted when the console is in roll or roll-deletable mode

ttt The time interval in seconds (1 - 999) between message deletes when the console is in roll or roll-deletable mode

msg The format of each message. Valid options are

T Display the message with a time stamp J Display the message with the issuing job's job number M Display the message text only; the message appears whether or not M is coded. S Display name of system that sent the message X 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


DPEC, Inc. 17

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 All deletable messages in the message segment are to be deleted (DEFAULT) N Number each message currently displayed on the console nn 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

Examples Function K E,SEG Deletes all deletable messages or in the message segment area K E of the console.

K E,1,6 Deletes lines one through six on the console.

K E,N Puts numbers on each message of the console screen, as the example below demonstrates.


18 DPEC, Inc.

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

CONSOLES--Display Management A3

DPEC, Inc. 19

In this objective you'll cover

• 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 Display only messages awaiting replies

U Display only pending mount requests

E Display only eventual action messages (tape unload messages, etc.)

CE Display only critical eventual action messages

L Display all action messages and pending mount requests

M Display all immediate action, eventual action, and critical eventual action messages, and messages awaiting replies

A3 CONSOLES--Display Management

20 DPEC, Inc.

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


DPEC, Inc. 21

Sample Output

D T IEE136I LOCAL: TIME=14.31.12 DATE=1999.040 GMT=TIME=19.31.12 DATE=1999.040

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


22 DPEC, Inc.

Output The next diagram shows sample output resulting from the K A,REF command.

STC00011 IST093I T08A02E ACTIVE STC00011 IST093I T08A03I ACTIVE STC00011 IST093I T08A04E ACTIVE STC00011 IST461I ACTIVATE FOR U/RNAME ENTRY ID = B01-S STARTED STC00011 IST020I VTAM INITIALIZATION COMPLETE STC00011 IST440I TIME = 14544335 DATE = 1999055 ID = PF01 769 STC00011 IST441I DLRMAX = 1 CHWR = 3573 CHRD = 3000 STC00011 IST442I ATTN = 3868 RDATN = 0 IPIU = 3000 STC00011 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


DPEC, Inc. 23

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 IST093I T08A03I ACTIVE STC00011 IST093I T08A04E ACTIVE STC00011 IST461I ACTIVATE FOR U/RNAME ENTRY ID = B01-S STC00011 IST020I VTAM INITIALIZATION COMPLETE STC00011 IST440I TIME = 14544335 DATE = 1999055 STC00011 IST441I DLRMAX = 1 CHWR = 3573 STC00011 IST442I ATTN = 3868 RDATN = 0 Message STC00011 IST443I OPIU = 3893 RDBUF = 3000 Area 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 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


24 DPEC, Inc.

STC00011 IST093I T08A03I ACTIVE STC00011 IST093I T08A04E ACTIVE STC00011 IST461I ACTIVATE FOR U/RNAME ENTRY ID = B01-S STC00011 IST020I VTAM INITIALIZATION COMPLETE STC00011 IST440I TIME = 14544335 DATE = 1999055 STC00011 IST441I DLRMAX = 1 CHWR = 3573 STC00011 IST442I ATTN = 3868 RDATN = 0 Message STC00011 IST443I OPIU = 3893 RDBUF = 3000 Area 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 Now reserved for the Display Area IEE612I CN=MASTER DEVNUM=0FE SYS=SYSTEM1 CMDSYS=SYSTEM1

IEE163I MODE=RD

STC00011 IST093I T08A03I ACTIVE STC00011 IST093I T08A04E ACTIVE STC00011 IST461I ACTIVATE FOR U/RNAME ENTRY ID = B01-S STC00011 IST020I VTAM INITIALIZATION COMPLETE STC00011 IST440I TIME = 14544335 DATE = 1999055 STC00011 IST441I DLRMAX = 1 CHWR = 3573 STC00011 IST442I ATTN = 3868 RDATN = 0 Message STC00011 IST443I OPIU = 3893 RDBUF = 3000 Area 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 When you IEE114I 15.48.26 1999.055 ACTIVITY issue aJOBS M/S TS USERS SYSAS INITS ACTIVE/MAX Display00010 00021 00041 00010 00024 00041/000 command, the output goes here. IEE612I CN=MASTER DEVNUM=0FE SYS=SYSTEM1 CMDSYS=SYSTEM1

IEE163I MODE=RD

6. The K D,F command breaks the status display into frames for scrolling.


DPEC, Inc. 25

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.

STC00011 IST093I T08A03I ACTIVE STC00011 IST093I T08A04E ACTIVE STC00011 IST461I ACTIVATE FOR U/RNAME ENTRY ID = B01-S STC00011 IST020I VTAM INITIALIZATION COMPLETE STC00011 IST440I TIME = 14544335 DATE = 1999055 STC00011 IST441I DLRMAX = 1 CHWR = 3573 STC00011 IST442I ATTN = 3868 RDATN = 0 This is frame STC00011 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 Display00010 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


26 DPEC, Inc.

STC00011 IST093I T08A03I ACTIVE STC00011 IST093I T08A04E ACTIVE STC00011 IST461I ACTIVATE FOR U/RNAME ENTRY ID = B01-S STC00011 IST020I VTAM INITIALIZATION COMPLETE STC00011 IST440I TIME = 14544335 DATE = 1999055 STC00011 IST441I DLRMAX = 1 CHWR = 3573 The message STC00011 IST442I ATTN = 3868 RDATN = 0 scrolls to STC00011 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 Display00010 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.

MONITORING SYSTEM ACTIVITY--Displaying System Activity B1

DPEC, Inc. 27

This unit presents the DISPLAY command. It also covers JCL errors and ABENDs.

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

B1 MONITORING SYSTEM ACTIVITY--Displaying System Activity

28 DPEC, Inc.

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 (or JOBS) Display the number of active batch jobs and started tasks

TS Display the number of active time-sharing users

A Display the number of active batch jobs, started tasks, and active time-sharing users

L (or LIST) Display names and detailed information about the selected items (J, TS, or A)

ALL Display more detailed information about the selected items than is provided by the LIST option


DPEC, Inc. 29

name Display even more detailed information about the named item

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 INITS ACTIVE/MAX VTAM OAS 00013 00021 00008 00010 00024 00008/00050 00000

The number of ...

Active Batch jobs Active System Started Active VTAM Total batch created TSO address initiators TSO users/ OpenMVS jobs by the users spaces Maximum VTAM address MOUNT or TSO users spaces START command

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

B1 MONITORING SYSTEM ACTIVITY--Displaying System Activity

30 DPEC, Inc.

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 SNames NET NET NET NSW S ICOM ICOM ICOM1 NSW S of OMEGAMON OMEGAMON IEFPROC NSW S CA7RPT CA7RPT RPTPROC NSW Sstarted EPICLOGC EPICLOGC GO NSW S CADSDISP CADSDISP CAIDC1A NSW Stasks VCSS1 VCSS1 CAVVVCSS NSW S CA7 CA7 CA7 NSW Sand TSO TSO STEP1 NSW S IMFTSEXS TA04 IEFPROC NSW Sbatch POPR0070 STEP0020 NSW J POPR0170 STEP0020 NSW Jjobs 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 is jobname, e.g. POPR0070 sss is the step currently executing, e.g. STEP0020 www is the status of the job, e.g. NSW means non-swappable x is 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


DPEC, Inc. 31

Syntax D J,name

Example D J,SYS122XX

Here is the output of the D J,SYS122XX command. Note these features:

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,sys122xxIEE114I 14.59.35 1999.040 ACTIVITY 891 JOBS M/S TS USERS SYSAS INITS ACTIVE/MAX VTAM OAS00010 00021 00041 00010 00024 00041/00050 00000 SYS122XX STEP0050 OUT J A=0031 PER=NO SMC=000 PGN=001 DMN=001 AFF=NONE CT=000.102S ET=261.676S ADDR SPACE ASTE=024D0C40

B2 MONITORING SYSTEM ACTIVITY--Job and Task Termination

32 DPEC, Inc.

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

• Syntax Errors: The JCL does not meet the syntax required by MVS (i.e. - missing commas, misspelled words, etc.).

MONITORING SYSTEM ACTIVITY--Job and Task Termination B2

DPEC, Inc. 33

• 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 IEF452I JOBFAIL JOB NOT RUN - JCL ERROR

Example 2 IEF452I SYS122J1 JOB NOT RUN - JCL ERROR $HASP396 SYS122J1 TERMINATED

Example 3 $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)

B2 MONITORING SYSTEM ACTIVITY--Job and Task Termination

34 DPEC, Inc.

-- 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.

- JOB00027 $HASP373 SYS122J1 STARTED - INIT 6 - CLASS I - SYS MVSA JOB00027 IEF403I SYS122J1 - STARTED JOB00027 CSV003I REQUESTED MODULE SBPA030 NOT FOUND JOB00027 CSV028I JOBNAME=SYS122J1 STEPNAME=STEP2 ABEND806-04 JOB00027 IEA989I SLIP TRAP ID=X806 MATCHED JOB00027 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

MONITORING SYSTEM ACTIVITY--Job and Task Termination B2

DPEC, Inc. 35

Here is a chart of common ABEND codes.

Code Meaning

806 The program to be executed could not be found; check the spelling of the program name, and the JOBLIB or STEPLIB specification

106 80A The REGION size on the JOB or EXEC statement was not large enough 878

813 The data set name in the JCL does not match the data set name in the tape label

122 The console operator cancelled the job and requested a dump

222 The console operator or the user cancelled the job

322 The job exceeded its TIME limit

522 The system wait time limit was exceeded

722 The job output limit was exceeded

A22 The operator cancelled the job with a FORCE command

This example is a console with numerous messages.

JOB00027 $HASP100 SYS122J1 ON INTRDR - JOB00027 $HASP373 SYS122J1 STARTED - INIT 6 - CLASS I - SYS MVSA JOB00027 IEF403I SYS122J1 - STARTED JOB00028 $HASP100 PGM108XX ON INTRDR - JOB00028 $HASP373 PGM108XX STARTED - INIT 9 - CLASS A - SYS MVSA JOB00028 IEF453I PGM108XX - JOB FAILED - JCL ERROR JOB00028 $HASP395 PGM108XX ENDED $HASP309 INIT 9 INACTIVE ******** C=A JOB00027 IEF457I SYS122J1 STEP3 STEP - ABEND=S322 U0000 REASON=00000000 $HASP309 INIT 6 INACTIVE ******** C=I JOB00029 $HASP100 SYS128QR ON INTRDR - JOB00029 $HASP373 SYS128QR STARTED - INIT 5 - CLASS I - SYS MVSA JOB00029 IEF403I SYS128QR- STARTED JOB00030 $HASP100 PGM111XX ON INTRDR - JOB00030 $HASP373 PGM111XX STARTED - INIT 8 - CLASS A - SYS MVSA - 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

C1 JOB AND TASK MANAGEMENT--START & MODIFY Commands

36 DPEC, Inc.

In addition to monitoring system activity, you may be required to perform job and task management functions.

Required Activity MVS Command Starting tasks START Specifying parameters to control job MODIFY or task execution Stopping jobs or tasks STOP Cancelling jobs or tasks 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 The name of the cataloged procedure that defines the task to be executed

keyword The name of a symbolic variable in the started task JCL

option The value to be assigned to the variable

JOB AND TASK MANAGEMENT--START & MODIFY Commands C1

DPEC, Inc. 37

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 STC00027 $HASP100 TSO ON STCINRDR - STC00027 $HASP373 TSO STARTED STC00027 IEF403I TSO - STARTED STC00027 IKT007I TCAS ACCEPTING LOGONS STC00027 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 The name of the cataloged procedure that defines the task to be executed

C1 JOB AND TASK MANAGEMENT--START & MODIFY Commands

38 DPEC, Inc.

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.

parameters The new or modified 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.

JOB AND TASK MANAGEMENT--START & MODIFY Commands C1

DPEC, Inc. 39

The parameters will be rejected if the program is not written to allow MODIFY commands.

JOB00030 $HASP100 SYS122JB ON INTRDR - JOB00030 $HASP373 SYS122JB STARTED - INIT 6 - CLASS I - SYS MVSA JOB00030 IEF403I SYS122JB - STARTED f sys122jb,hello IEE341I SYS122JB NOT ACTIVE

NOT ACTIVE indicates that the program was not written to accept MODIFY command input.

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.

d ts 11.48.33 IEE114I 11.48.33 1999.108 ACTIVITY JOBS M/S TS USERS SYSAS INITS ACTIVE/MAX VTAM OAS 00000 00003 00013 00009 00015 00013/00050 00000 f tso,usermax=15 d ts 11.49.27 IEE114I 11.48.33 1999.108 ACTIVITY JOBS M/S TS USERS SYSAS INITS ACTIVE/MAX VTAM 00000 00003 00013 00009 00015 00013/00015

C2 JOB AND TASK MANAGEMENT--STOP & CANCEL Commands

40 DPEC, Inc.

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 The name of the job or started task to be stopped

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

JOB AND TASK MANAGEMENT--STOP & CANCEL Commands C2

DPEC, Inc. 41

Description jobname The name of the job or started task to be cancelled

DUMP Generate a dump when the CANCEL command is performed

asid The hexadecimal address space identifier of the work unit to be cancelled

ARMRESTART Indicates an automatic restart after the cancel completes

userid The logon ID of the TSO user to be cancelled

identifier The device number (0000 - FFFF) or device type. Precede a device number with a / to distinguish it from a device type.

Examples C SYS122CM,DUMP Cancel the job named SYS122CM. The job will ABEND with system ABEND code 122 and generate a dump.

C U=TS05 Cancel TSO user TS05. The TSO session will ABEND with system ABEND code 222.

C 580 Cancel the job with a mount request pending for device number 580. The job will ABEND with system ABEND code 222.

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 The name of the job or started task to be terminated

ARM Required to FORCE jobs or started tasks that are marked as non-cancelable

C2 JOB AND TASK MANAGEMENT--STOP & CANCEL Commands

42 DPEC, Inc.

asid The hexadecimal address space identifier of the work unit to be cancelled

ARMRESTART Indicates an automatic restart after the cancel completes

userid The logon ID of a TSO user to be terminated

identifier The device number (0000 - FFFF) or device type. Precede a device number with a / to distinguish it from a device type.

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.

JOB AND TASK MANAGEMENT--STOP & CANCEL Commands C2

DPEC, Inc. 43

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.

• 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 IEF861I FOLLOWING RESERVED DATA SET NAMES UNAVAILABLE TO SYS122T JOB01836 IEF863I DSN=TEST.ACP.MASTER JOB01836 *IEF099I JOB SYS122T WAITING FOR DATA SETS

D1 DEVICE MANAGEMENT--D M, VARY and D U Commands

44 DPEC, Inc.

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

DEVICE MANAGEMENT--D M, VARY and D U Commands D1

DPEC, Inc. 45

Data Set Name A 44 character value used to uniquely identify each data set

Example

SYS122. TEST.MASTER HARDWARE ARCHITECTURE CPU Each storage device (disk, tape, cartridge) is connected to Channel Subsystem a control unit. CHPID > 00 01 ... ... ... ... FF Each control unit is connected to the channel subsystem via a channel path. Control Control Channel paths are assigned aPath Unit Unit 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.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.


46 DPEC, Inc.

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 A single channel path chpid,chpid Multiple channel paths chpid-chpid 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. So, the system displays channel path 01.

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.


DPEC, Inc. 47

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 E F 12 + + + + + + + + + + + + + + + + 13 + + + + + + + + + + + + + + + + 1A - @ . . . . . . . . . . . . . . ************************ SYMBOL EXPLANATIONS ************************ + ONLINE @ PATH NOT VALIDATED - OFFLINE . DOES NOT EXIST * PHYSICALLY ONLINE - PATH NOT OPERATIONAL

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.


48 DPEC, Inc.

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 A single device dev,dev Multiple devices dev-dev A range of devices

chpid 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.


DPEC, Inc. 49

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.

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 A single device (dev,dev) Multiple devices (dev-dev) A range of devices

ONLINE Make the device available for use

OFFLINE Make the device unavailable for use

Examples V 580,OFFLINE Places device number 580 offline.

V (120-127),ONLINE 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 STC00010 IEF403I DEALLOC - STARTED IEE303I 44F OFFLINE STC00010 IEF404I DEALLOC - ENDED


50 DPEC, Inc.

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


DPEC, Inc. 51

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. Valid options are

DASD Disk drives TAPE Tape/cartridge drives UR Unit record devices (Printers, card readers, etc.) TP Communications equipment GRAPHIC Graphic devices CTC channel-to-channel adapters ALL All of the above devices (DEFAULT)

ONLINE Display the information only for online devices

OFFLINE Display the information only for offline devices

ALLOC 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)


52 DPEC, Inc.

dev The device number (0000 - FFFF) of the first device to be displayed (DEFAULT = 000)

num The number of devices for which information is to be displayed

The DEFAULT for

ONLINE or OFFLINE is 16 ALLOC 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.

D U Display the information for the first 16 online or offline devices beginning with device number 000.

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


DPEC, Inc. 53

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 STATUS 259 UNIT TYPE STATUS VOLSER VOLSTATE UNIT TYPE STATUS VOLSER VOLSTATE 780 3480 O PRIV/REMOV 781 3480 O PRIV/REMOV 782 3480 O PRIV/REMOV 783 3480 O PRIV/REMOV 784 3480 A-NRD 003399 PRIV/REMOV 785 3480 A 002987 PRIV/REMOV 786 3480 A 002542 PRIV/REMOV 787 3480 A 003231 PRIV/REMOV 788 3480 A-BSY 008859 PRIV/REMOV 789 3480 A-MTP 001263 PRIV/REMOV 78A 3480 A-MTP 003350 PRIV/REMOV 78B 3480 OFFLINE 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. Tape drive unit 270 is in use by the job DITTO1.

d u,dasd,alloc IEE106I 11.33.17 UNITS ALLOCATED 261 UNIT JOBNAME ASID JOBNAME ASID JOBNAME ASID JOBNAME ASID 120 CONSOLE 0008 CALC2 0022 125 NET 0021 130 RMF 000D 134 LLA 000C *MASTER* 0001 CATALOG 0002 PCAUTH 0003 135 ALLOCAS 0004 DUMPSRV 0005 TRACE 0006 GRS 0007 d u,tape,alloc IEE106I 11.32.56 UNITS ALLOCATED UNIT JOBNAME ASID JOBNAME ASID JOBNAME ASID JOBNAME ASID 270 DITTO1 0026

D2 DEVICE MANAGEMENT--Problem Resolution

54 DPEC, Inc.

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 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'

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.

DEVICE MANAGEMENT--Problem Resolution D2

DPEC, Inc. 55

IEF244I 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.

IEF244I 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.

IEF244I 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.


56 DPEC, Inc.

If the job should release all its allocated drives until the remaining drives become available, use the same syntax with NOHOLD.

IEF244I 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 FOLLOWING VOLUMES UNAVAILABLE TO SYS122T STEP01 IEF690I 735356 *37IEF235D SYS122T STEP01 WAITING FOR VOLUMES, TO CANCEL WAIT REPLY 'NO'

Now let's consider how to swap a volume.


DPEC, Inc. 57

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

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 Proceed with the swap as indicated r id,NO Cancel the swap request r id,nnn 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 then physically moves the tape or cartridge and loads it onto device 681. (In some installations the load is done mechanically.) Only then does MVS give you the COMPLETE message shown below.

STEP 1 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.


58 DPEC, Inc.

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 Possible problems Printers The printer has run out of paper. A paper jam has occurred. A forms change is required. Tape The tape did not load correctly. The ready button was not pushed. Disk The switches were not set correctly on the disk drive.

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


DPEC, Inc. 59

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 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


60 DPEC, Inc.

• 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 The device number (0000 - FFFF) of the device to be mounted

volser The 1 - 6 character serial number of the volume to be mounted

PRIVATE The volume may only be used by jobs that specifically request the volume (DEFAULT)

PUBLIC The volume may be used by any job to create temporary data sets

STORAGE 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.


DPEC, Inc. 61

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

IOS001E 590,INOPERATIVE PATH 05 The path that has become inoperable The device which has lost the path access


62 DPEC, Inc.

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

BROADCAST MESSAGES--SEND & LOG Commands E1

DPEC, Inc. 63

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

• 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 The message to be sent to a TSO user

userid The TSO user ID(s) to receive the message; multiple user IDs may be enclosed in parenthesis and separated by commas.

ALL Send the message to all TSO users (DEFAULT)

LOGON Send the message immediately if the specified user is logged on and receiving messages; otherwise, save the message until the next user logon

NOW Send the message immediately; if the user is not currently logged on, the message is deleted (DEFAULT)

WAIT Hold the message until system output buffers are available (DEFAULT)

E1 BROADCAST MESSAGES--SEND & LOG Commands

64 DPEC, Inc.

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

BROADCAST MESSAGES--SEND & LOG Commands E1

DPEC, Inc. 65

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 The message to be sent to another console

BRDCST Send the message to all active consoles

code Send the message only to consoles defined to receive this route code

console The ID (0 - 99) of the console to receive the message

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'

F1 PF KEY ASSIGNMENTS--Displaying and Setting

66 DPEC, Inc.

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

PF KEY ASSIGNMENTS--Displaying and Setting F1

DPEC, Inc. 67

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 PF KEY ASSIGNMENTS--Displaying and Setting

68 DPEC, Inc.

Description nn The number of the PF key to be defined

text The command to be associated with the PF key; multiple commands may be specified if separated by semicolons

mode 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

N The command will be issued immediately when the PF key is pressed (DEFAULT)

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.

Documents

Basic Mvs Operations