OEseR IPTION Restore CPWRK

Exit program.

m

Restore CPWR K.

Route control to #CCSJ.

Ensure job queue supported.

Save portion of work area.

Assign space for lOB, FDT, AND text sectors of format and execution time data area.

Free all but execution time data area.

Check if first call and if forward (F), reset (R), or update (U) page control character entered:

• Ensure job queue supported.

o

Read job queue file index sector.

• If status not active or R entered, set first entry on job queue as start of display.

o

If no page control character entered, assume forward (F) character and chain through queue to find entry by position number.

Ensure queue not empty.

If job name given, find entry requested.

Read entry into buffer.

If command from work station, ensure user ID and work station ID match.

Format requested display in output buffer:

o

If work station request, work station ID and user ID must match.

o

If system console request, format all input job queue entries.

Build work station data management parameter list.

Display job queue entries.

Free output area and restore work area.

Load and pass control to #CPML.

1m)

Restore CPWR K.

Route control to #CCSW.

Save portion of work area.

Assign space for lOB, FDT and text sectors of format, and execution time data area.

Call message retrieve to retrieve translatable constants.

Free all but execution time data area.

If operand 2 given, start function with work station given in operand 2.

If R control character, start with first TUB.

If U control character, start with current work station in SQE.

Diagram 2.16' (Part 4 of 6). Perform STATUS Command Processing 2-40

Licensed Material-Property of IBM

MODULE!

DESCRIPTION

If F or other control character, start with forward work station in SQE.

Build line of output for each device.

At end of page, display page (if automatic status, display format that does not clear input).

Free output area.

Restore work area.

Exit program.

II

Ensure not in console mode.

Restore CPWR K.

Route control to #CCSS.

Save portion of work area.

If I option, start page 1.

If R option, start page 1.

If U option, start from current page pointer in SQE.

If F option, start from forward page pointer in SQE.

If start page

=

2:

• Restore CPWR K .

• Route control to #CCS2IJO.

Assign space for lOB, format text and FDT sectors, and execution time data area.

Call message retrieve to retrieve translatable fields and place in transient area (if retrieve fails, use English version).

Free all but execution time data area.

Build page 1 information.

Set up SQE for current page = 1 and forward = 2.

Call work station data management to display page 1 (if automatic status, display format that will not clear input lines).

Free execution time data area.

Restore CPWR K.

Exit program.

" Save 30 bytes of CPWR K.

Assign enough space for format FDT and text sectors, lOB, and execution time data area.

Call message retrieve to retrieve translatable fields and place in work area (if message retrieve fails, use English version).

Free all but execution time data area.

Diagram 2.16 (Part 5 of 6). Perform STATUS Command Processing

MODULE!

ROUTINE

#CCSW

#DWDM

#CCSW

#CCSM

#CCSS

#MGRET

#CCSS

#DWDM

#CCSS

#CCS2

Method of Operation 2·41

Licensed Material-Property of IBM

OEseR IPTION

Build page 2.

Set up SOE current

=

2, forward

=

3.

Call work station data management to display page 2 (if automatic status, display format that will not clear input lines).

Restore CPWR K.

Exit program.

o

Save 30 bytes of work area.

If U option, begin function with page in SOE.

If F option, begin with forward page in SOE.

If page 4, go to

II e.

Assign space for format FDT and text sectors, lOB, and execution time data areas.

Call message retrieve to retrieve translatable fields (if retrieve fails, use English verison).

Free all but execution time fields.

Build page 3 data.

Indicate in SOE forward page

=

4, current

=

3.

Call work station data management to display page 3 (if automatic status update, do not clear input lines).

Restore CPWR K.

Exit program.

e

Assign space for format FDT and text sectors, lOB, and execution time data areas.

Store assign area address in WDRECA into CPWRK.

Call #CCS4 to build execution time data.

Build execution time data for page 4.

. Free all but execution time data area.

Point SOE forward to 1, current

=

4.

Call work station data management to display format (if automatic status update, do not clear input lines).

Exit program.

Notes:

1. If errors occur, call #CMCU to issue error message.

2. If SOE is new, dequeue and free SOE.

Diagram 2.16 (Part 6 of 6). Perform STATUS Command Processing 2-42

Licensed Material-Property of IBM

MODULE/

ROUTINE

#CCS2

#DWDM

#CCS2

#CCS3

#MGRET

#CCS3

#DWDM

#CCS3

#CCS4

#CCS3

#DWDM

#CCS3

From: Input Router (#CPRT) INPUT _ _ _ _ _

XR2 (CP work area

Main Storage

Transient Area:

#CCTD User Area

L...::;:0CESS

D

Process TIME command

---:rJ

... ..

~

OUTPUT _ _ _

_

. Time and date in command processor work area

Parameter list for #CMCU

To: Cleanup Routine (#CMCU)

MODULE/

OEseR IPTION ROUTINE

D

Initialize timer request block. #CCTD

Get time of day and date and place in command processor work area.

Build parameter list for #CMCU.

Pass control to #CMCU to display time and data.

Note: If errors occur, call #CMCU to issue error message.

Diagram 2.17. Perform TIME Command Processing

Method of Operation 2-43

Licensed Material-Property of IBM

From: Input Router (#CPRT)

'" INPUT _ _ _ _

..

~OCESS

Required system areas

_ - - -.... :>" ... •

Perform job start function (Diagram 2.19)

• Perform release function (Diagram 2.20)

I r ^OUTPUT

-..;;;...--->

Initiator start

I I

______ -=-... >

Appropriate

display

~---:Tl

To: Initiator (#CIML) Diagram 2.18. Overview of Job Initiation and Work Station Release

2-44

Licensed Material-Property of IBM

From: Command Processor Input Router (#CPRT)

II

Start initiator if applicable

---Tl

To: Cleanup (#CMCU)

OEseR IPTION

D

Call cleanup routine (#CMCU) to issue message:

• If initiation stopped (TUBSTPJ), issue job initiation stopped by system operator error message (MIC 5534).

• If terminal in console mode (TUBMCNSL), or if terminal is data terminal (TUBCMDT), issue command not allowed error message (MIC 5539).

D

Check procedure to see if it is for active multiple requester terminal (MRT) program.

If not for MRT, go toll.

Ensure request valid:

• Inquiry requester not attempting to attach to a MRT waiting for resources.

• Inquiry requester not attaching to same MRT.

Calculate data input length and place in MRT.

Write input data to MRT data save area (WSWA).

Update MRT task control block (TCB) fields for active requester count, allocated work station count and task invite count.

If MRT task can not handle another requester (TCBMRTMX), set TUBECM skip flag (TUB$SKIP) off.

Set MRT TCB address in requester TUB to designate ownership.

Build action control element (ACE).

Activate data mode in TUB.

Diagram 2.19 (Part 1 of 2). Perform Job Start Function

XR2-CP work area

Method of Operation 2-45

Licensed Material-Property of IBM

MODULE/

OEseR IPTION ROUTINE

Post MRT task to accept input from new requester. #CPRT

Pass control to cleanup routine (#CMCU) to log input.

II

Build initiator attach parameter list.

Activate data mode in TUB.

Pass control to supervisor task attach transient (#SVAT) to start initiator (# CI M L). ' #SVAT If attach fails, display error message.

(

Diagram 2.19 (Part 2 of 2). Perform Job Start Function 2-46

Licensed Material-Property of IBM

From: Command Processor Resident Routine (#CPML)

~INPUT

Main Storage

Transient Area:

#CPTC User Area

JCB SCA TCB TUB TUB chain

LJ;;:0CESS

_ - - - -... 100.:> ... D

Process release request

---:Tl

OUTPUT _ _ _ _

JCB TUB

Command display or Standby display

or Sign-on display

To: #CPML Via High Level Aids and Task-To-Task Communications Router (Diagram 2.21)

MODULE/

DESCRIPTION ROUTINE

D

Jf termination cleanup required prior to release, call initiator with termination hook. #CPTC If test request, call #CCOF.

If no more job ste,Ps: #CPIO

•

Initialize TUB fields. #CPTC

0 If restore not required invite display station for Enter key. #CPIO

•

If any messages to be displayed, call #CCMX. #CPTC

•

Display command interface.

•

Post tasks which may want this display station.

•

^Return.

If more job steps:

•

If end of outermost procedure, setup hook for initiator to call termination (TUBABTRM).

•

Start initiator.

•

If initiator attach fails, set timer interrupt to retry in 2 seconds. #CPTC

•

^Return.

Diagram 2.20. Perform RELEASE Function

Method of Operation 2-47

Licensed Material-Property of IBM

From:

INPUT

Command Processor Resident Router (#CPML)

~OCESS

D

Process task-to-task communications

fJ

Process TUBs for high level aids

II

Route for pending system functions

..

---::11

To: #CPML

DESCRIPTION

II

If I/O error, process it.

If display station release,

process it. (See Perform Release Function"Diagram 2.20.)

fJ

If system request,

process request. (See Process System Request Event, Diagram 2.30.) If Attn key:

•

If the vertical hold or save/restore interlock is on, pend the inquiry and retry in 2 seconds (NUASGN).

•

If the interrupted task is a SRT:

-

If 1 option is pending, and if SOB count

=

0, and if posted because of Attn key, then erase 1 option pending and process inquiry.

-

If SOB count

=

4, post tasks waiting on disk enqueue.

-

If task owns interlocks, retry Attn key in 2 seconds (NUASGN); otherwise, suspend task.

-

Build an inquiry TUB and work station work area.

-

If no resources are available, retry inquiry and go to

DO.

Diagram 2.21 (Part'1 of 2). Perform High Level Aids and Task-to-Task Communications Router Functions 2-48

Licensed Material-Property of IBM

I

OUTPUT _ _ _

_

OEseR IPTION MODULE!

ROUTINE

•

If the Interrupted task is a MRT: #CPTC

-

If display station not invited, retry inquiry.

-

Indicate TUB to be skipped.

-

Build inquiry TUB.

-

I f no resources available, retry inquiry.

-

^If implicit invite to TUB or if PRUF (put for read under format) invite, decrease requester and work station count.

o

Swap the new TUB and the inquiry TUB: #CPIQ

• Find the previous TUB on the TUB chain.

•

Lock the TUB chain.

•

Rechain the new TUB to the TUB chain.

•

Unlock the TUB chain.

•

Post other TUB users.

•

If a JCB exists:

-

Free up JCB and FSBs chained to it.

-

Free up WSWA.

· ^-

Free up TUB.

Save the work station display. #CPIO

If inquiry option 1 was pending, #CPTC

~process 1 option. Otherwise, #CPIQ

put up inquiry display. #CPIO

Return to caller. #CPTC

If Help key,

process. #WDDH

II

If console SVSLOG is pending, #CPTC

process it. #CMCI

If stop pending for any task, and if interlocks are now freed, suspend the task. #CPTC

If stop system is pending, and stop is complete, #CCRT

process the completed stop. #CPTC

If JOBQ detach is pending,

process next JOBQ task. #CCJS

Diagram 2:21 (Part 2 of 2). Perform High Level Aids and Task-to-Task Communications Router Functions

Method of Operation 2·49

Licensed Material-Property of IBM

From: Input Router (#CPRT)

~INPUT-' ~OCESS

TUB, TCB, SCA I I

Inquiry option

>-

Perform inquiry menu processing function

I I

(Diagram 2.23)

TCB, JCB, and TUB

:>.

Perform resume function (Diagram 2.24)

I ^{r OUTPUT .}

---.;;;~---...;;->

Menu or Command

I I

^display

_-=-____ -=...,> ....

User display

To: Resident Router (#CPML) Diagram 2.22. Overview of Inquiry Menu Option Processor and Resume

2-50

Dans le document Property of IBM (Page 95-105)