1 U S 1990

I"CrTlC'1"IO,I'ClI'"1 trademark of

Release 13.0

Priced Item

1990 Printed in U S America UP-11907 Rev. 1

The names, places, or association existing, names of any individual, unintentionaf.

events used in this publication are not intended to ,..,,,,,,,enn.,r/

or otherwise. similarity or'likeness of the names,

or otherwise. or of any group or association is purely "";",...;,,lont·,,1

NO WARRANTIES OF ANY NATURE ARE EXTENDED BY THIS DOCUMENT. Any product and related material disclosed herein are only furnished pursuant and subject to the terms and conditions of a duly executed Program Product License or Agreement to purchase or lease equipment. The only warranties made by Unisys, if any, with respect to the products described in this document are set forth in such License or Agreement. Unisys cannot

financial or other responsibility that may be the result of your use of the information in this document or material, including direct, indirect, special, or consequential damages.

You should be very careful to ensure that the use of this information and/or software material complies with the laws, rules, and regulations of the jurisdictions with respect to which it is used.

The information contained herein is subject to change without notice. Revisions may be issued to advise of such changes and/or additions.

Correspondence regarding this publication should be forwarded to Unisys r'""'n,,r'::.tirln

Reply Mail form at the back of this manual or addressing remarks directly Unisys Product Information Development, P.O. Box Mail Station E5-1l4, Blue Bell, t-'erlnSli'ivalnia.

1 thru 19

Tab Breaker

Appendix

1907 Rev.

Page Page

Number

iii

a series ^{U. ...} ''''~MAA....,U.

for en'lrir(mnllerLt. It describes all ast)eC1CS

""n·n"' ... '·' ... ICAM

att,ernlptllngto and~oT,n~oro

nnv, "o, ... 'nno the features and

You must also be rn." ... "."n'n

cornnutE!r "',,,1-,,, ... and its associated communications network.

This is intended for the IMS administrator and "-.yc,f-n·...--,,

overview of IMS and describes C!'''C~t-01ITl ""''''Ol'"\Q'<QT1",n

functions .

... u ... b extensive use of this AAJ.<..UJ.UC<AJ..

a

a

It

ers:tm:lC11ug of the IMS how it and what you need to do to make it

op~eraltl(mall. This information is contained in the 1MS Technical UP-9205.

also be familiar with the contents of the other manuals listed in the sut)sectllon. "Related Product Information".

and describes how you can

... " ... A.U ... F,. Describes to normal

Section Batch ~loc~es~nn.2: Transactions Describes how:

Batch pn)CeSslng works and when to use messages are handled To set

prepare the batch processor start and control batch pr()ce~ss],ng-

To run IMS batch prC)CeSSlng- without a communications ... "'''hn'',..1r

To resume restart

File

Discusses online and offline file recovery functions. Describes the audit

message and trace file. what you need to do at time and execution time in order to use these files. Describes 1MS file recovery after a transaction is terminated or after a restart. Tens how you can restore files left in an inconsistent state termination or

"' .. "'·'1"0',... failure.

Section 8. IMS

Gives an overview of the statistical and lists an statistical data

1-'''-" ... ..,..., ... Describes the information you must to the COIlll~~rat()r

statistical data. how and when statistical data is .... "'''.o ... '"ilarl

describes the you must take to the statistical program.

Describes the conventions of IMS statement and paraIne'[;er formats.

Provides for eS{,nnaLlng re(~Ulrernelnts for eXE3cu.uDLg thread and multithread IMS "' .. ,,"''1".0 ... '"

TlJ}en4::nx C. m1nIC ... O'll"',...«Performance ofIMS ~ .. "".""£> ... OS/3

Discusses some ways to ensure the most efficient ... '"'·_o .... n-.o..-."o of IMS under OS/3.

UP-l 1907 vii

U"MJI'H«-C-' aOC1'1m~ent. use the

extensive

" ' 0 1 " 0 ' ' ' , 0 . messages at terminals.

commands to

Information ...,.""" ... ,.." A.

1-1 1-2 1-3 1-3 14 1-6 1-7

2-3 2-5 2-11 2-14 2-17 2-19 2-25 2-25 2-25

3-1 3-2 ... 3-2 3-4 3-6 3-9 3-10 1 3-11

481 482 482 483 483

4-90 4-91 4-91 4-92 4-93 4-93 4-94 4-94 4-107 4-108 4-108 4-108

4-109

4.3.10.

1.

UP-l 1907

4.3.12.

5.1.

5.2.

5.2.1.

5.2.2.

5.3.

5.3.1.

5.3.2.

5.3.3.

5.4.

6.1.

6.2.

6.3.

6.3.1.

6.3.2.

6.4.

6.4.1.

6.4.2.

6.5.

the Record IIn"",.,,,,,rrt:\I'Y'I,,,n'l" Interface - the DRCRDMGT Section

Specifying Residence for Defined Record Specifying Defined Record

Management Functions

4-131 4-132 4-132 4-133

General ... ... 5-1

t.st.abillshing the Communications Environment ... . Loading ICAM ... . the Global User Service Task ... ..

the IMS load Module ... . Parameter Statements in the Control Stream

of

v'I"olnf'lIrHT a or Disk Trace File Disabling Write Protection

'nc' ... ^lnlina a Character

""'''<lr'Il'.lInn Distributed Data PrOICeS!5Ing

Message

'nc' ... ^'T\lIna Number of DDP Sessions

5-1 5-1 5-2 5-3 5-4 5-5 5-6 5-7 5-7 5-8 5-8

Monitoring Online IMS ... 5-8

Overriding Transaction Buffer Pool ... 5-9

Processing Batch Transactions .... ... 5-9

Specifying an Module That Is on a Disk File ... 5-10 Job Control Stream for IMS Execution ... 5-10 Modifying Action in the LDPFILE ... 5-18 TtlIl-rnin~tinC1 the IMS Session ... 5-18

... 6-1

Cnlntrt'lllil"lC1 Batch Transaction Pr(Jlce!~sir1lg ... ..

Effect of IMS

l\C'C'llrrnlr)a Print Files to Batch Pseudoterminals ... ..

'nntlrnllirHl Batch Processor ... ..

Data in Control Stream ... . 6-2 6-6 6-6 6-7 6-7 6-7 6-8 6-8

for Batch Processor ... 6-8

6-13

6-13 6-14 6-15 6-16 6-16 6-17 6-17 6-17 6-17

7-1 ... 7-2 7-2 7-3 7-3 7-6 7-7 7-7 7-8 7-8 7-9 7-10 7-11 7-11

'1111 1-.1'+

7-18 7-23 7-23 7-24

... 8-1

Transaction Statistics ... .

UP-l

8-2 8-2

UP-l

C-7 C-9

xvii

IMS r..orlol'"~tirm and IJl'"nirOC'~lna

I\I"t,,' .... 'rv Definition Unsolicited ... . Communications Network for ICAM Unsolicited ... . Global Network Definition ... . Global Communications Network ... . Definition for GlobailCAM with Workstations ... . Communications Network for GlobailCAM with Workstations ... . Network Definition for GlobailCAM Distributed Data 1J1'"/'11/"'t:>C~C:IrI<1

"·'\i',,',, .... hrlrr Distributed Data 1J ... ;f"oco""'r'N

3-1. Control Stream to and Initialize the NAMEREC File ... 3-3 Control Stream Scratch and Reinitialize NAMEREC File ... ..

3-3. Control Stream for Password Definition and of Records in the

NAMEREC File ... . Control Stream for an ,-.. " ... ",,.,, , ... '"

3-5. Control Stream for Password Deletion of Records in the

NAMEREC File ... 3-10 IMSCONF

Card

Process ... . from a Workstation ... . Flowchart for IMSCONF Parameters... 4-13

of NAMEREC File Listed the IMS ... ..

4-62

... 5-1

7-3. Job Control Stream for 7-4. Job Control Stream for Job Control Stream for File Statistics Printed 8-2. Statistics Printed

Transaction Statistics Printed the 8-4.

8-5. Terminal Statistics Printed Job Control Stream for

Schedule for V<AI\~UI<AlIllh

8-3.

Calculation of Main

1

... 2-3

4-96 4-98 File ... 4-99 ... 4-100 ... 4-102 ... 4-103

File 4-105

4-106 7-2 ... 7-5

Multithread Control Table Sizes ... ..

Main IMS ... ..

General Formulas un.,,,,?,,," IMS Performance C-I0

Elements ... 0-1 ... E-1 ... E-3

1.'>rrln" .. 1-' .... Mess,a~E~S ... E-I0

UP-1l907

is a data

online from remote terminals for the

... 1J ... u.v.L.u,;;;. your files. For each message, IMS the

'if'Aror" .. ,c<,nN and with an message to the

terminal. With your programmers do not have to be data communications

OVT"IO.,..t-C because IMS you with the services:

Access to your data files

... "' ... ,'F. of transaction

"u._ .. ..,A-A • .l.h, and communications messages

"-,,,,_LAv,-,-,,,,,,--,-,-,,>'. pro(~essm,g sequences on message context

Communications network access

n-rrnnf'lOC for the data ,..,>i"AnhO,1-·-.7

prIOCt~SS:lnig. Data nlodifications are -'-vF.F.v ... and recovery are available.

In addition to online transaction

<:,<£\<,.",..,1--.7 necessary in real-time

and offline data file

-n-..,,,,,,,,oC' a batch transaction

processor that you can use in offline or online mode for vu. ... "",,-'-v-'--"-runs batched transactions or for V'-'''-'','-'._U'F.

a collection of software roA''''' .... 'Ar.r.r't-

installation. You

for offline recovery

,.,..n1hrn, ... ",. an online IMS load the IMS control n ... ,,\(>o,rI.,,·Q

IMSCONF The COlltl~:;UI'at:LOn process also allocates and initializes the

2. The

When

"·ne-"!-,..",,.,... is illustrated

offline recovery functions.

three eX(~eDtlOns:

, which

must be initialized before and

edit tables. If the NAMEREC file is must

you must consider of SYSGEN:

SETIME Inac;rus the

Sn'c ... ,iC'<r the number of communications aallpters communications lines

theCOMM

Sn,a,.nlihr at least three transient areas

" .. ,,:,i-A..,"'· at least four for multithread. If

at least transient areas.

-..;.,..,.,..,.",1· .. , at least two task levels

at least four for multithread.

IMS allocate

for SmlgH~-Lj~n!aa

for IMS. If other

UP-l

START

GENERATE GENERATE

SUPERVISOR THAT SUPPORTS IMS

ICAM LOAD

COMPILE OR MODULE THAT

ASSEMBLE SUPPORTS IMS

ACTION PROGRAMS

- ,

I I I

r--

I I

NAMEREC I

FILE I

I I

I I

I I

I

I 0

I I

I

I- ^GENERATE

I I

EDIT TABLES I

I

I I

I I

I I

I

I 0 ^I

!

I

I- ^GENERATE

I I

DEFINED FILES I

I

I I

I I

I I

I I

I

I DEFINE ^I I

t- ^{PASSWORDS I}

I I

I I

I I

!

I I

I I

i

I ^CONFIGURE

I

I ^ONLINE

I

I ^IMS

..,

i I

I

IMS I

I I

INITIATE ONLINE IMS

PROGRAM

,

LOAD FILE

ONLINE PROCESSING

®

OFFLINE RECOVERY NOTES

;

for UNIQUE; OP

110; ,1S, not applicable to 6 Optional

for UNIQUE nt' al for user action o available for user programs

When you use of a communications

the shown in , is your IMS load module

the other end are your terminals. In between are two of interfaces. The communications is a hardware device that takes messages in from

your and them in a form usable the vice versa.

The other the communications access method is the

... " ... JI'-".,u of this section. It's a software that controls the

to the terminals. Because of -- you can have

<.4AAp:.,-,.U">..,AAU of lines and terminals without IMS or your action

aware of what hardware with.

ICAM is a number of different

ICAM has four different interfaces and two of networks --u. .... , ... ...,u,,'-,u.

You'll be an interface created for use the transaction control interface You can use it with a dedicated network or a network. A dedicated network your IMS program. All the lines and terminals defined in the network definition are dedicated to IMS for the life of a session. network can be used your IMS program and other communications user programs at the same time. Communications lines can be and terminals can be attached to and detached from IMS and other programs the session.

To use the communications you must create an rCAM that C'''7Vnf'l.r''C!

your network of terminals and the interfaces needed You define the ICAM

"""vn' ... ,. H.'-"~Uv'u. with a set of ICAM network definition macros. These macros are then

h ... r,,,nrh the and of C'"<7Cd-n1rY'1 nr,,.,..,,..'''' ... ..,,1",,., ...

either when you create your or in a "01'"10,,.<:l'l"

create your ICAM need the current versions of the manuals:

fn,1'rrv,fnrl Communications Method

howICAM

a

is the "'".-nnnn,"'nt to and from the

terminals.

The communications adapter interfaces the hardware and the software.

IMS

COMMUNICATIONS

1

line

TERM Defines the characteristics of a terminal. For resident ICAM, also creates output queues

1

that line.

continued

Table Network Definition Macros

Macro Function Remarks

SESSION Sets up a static session path between a terminal and IMS or between a process file and IMS

Required for process files and static session terminals in a global network.

PRCS Creates a process file This feature is used only for an IMS system using unsolicited output.

The ICAM network definition macros vu."''',-,u..AJ the ofICAM

,UH,C;J.JLUvC;. your network of lines and

You use the CCA macro to a global network or a dedicated network that uses the transaction control interface. In a you use the LOCAP macro to define a transaction control interface.

Your network is the terminals for the collection of data to IMS and the distribution of information out of it. You must define

anj:;entlerlt for ICAM with LINE and TERM macros. In a

you also use SESSION macros to define static session terminals -- those terminals that are attached to IMS during an entire IMS session.

2-2 shows the for a resident rCAM. In a

resident ICAM stores messages in main storage buffers and messages in either main storage or a disk file. IMS may that an

message be stored in a disk buffer file if main buffer space is not available. You define the disk buffer and disk files with DISCFILE macros and a set of network buffers with the BUFFERS macro. When

nl'\""I,h'-'-""'Q an IMS that unsolicited you also create a

file for unsolicited messages with the PRCS macro. In a network

"""-''Y'>r,,.'h,r.rI' unsolicited you must include a SESSION macro for each

process file.

UP-l

Messages coming into the central processor from the terminals are put into a main storage or disk buffer by ICAM. When IMS requests a message from ICAM, ICAM takes it from the buffer and passes it to IMS.

When IMS outputs a message, ICAM puts the message into a main storage or disk queue. After ICAM finishes processing the message, it is transmitted to the appropriate terminal.

2~2. How IMS

IMS

COMMUNICATIONS ADAPTER

When you use a resident rCAM to "'''· .... n,'' .... t-

A dedicated network communications

DISK BUFFER

FILE

DISK QUEUEING

FILE (OPTIONAL)

you can have the

U.U.A H.J'''' 0..> , which may consist of:

Terminals

UNISCOPE 200 Terminals

UNISCOPE is a registered trademark of Corporation.

features:

communications

Unattended ...,r>C'TTU" ... .; ...

varriC"tcwnri trademark of

IBM is a v ... v,'"tc.VOI'

the

2-3 shows a dedicated network definition for a resident ICAM module that

"'n .. '.,.,.,., .... i-'" a or multithread IMS without unsolicited

2-4 shows the communications network.

Explanation 72

---11---

LNE1

TRM1

TRM2

TRM3

TRM4

LNE2

PASSWORD=IMC,

St\VE~YESIl

FEATURES=(OPCOM,OUTDELV)

BUFFERS 40, 64, 5, ARP=25

LINE DEVICE=(UNISCOPE)

TYPE=(2400,UNAT,SWCH,SYNC), X ID=04

Gives name network interface

Gives network password

Specifies that CCA object module is saved $Y$OBJ

lows console operator communications with ICAM and includes module needed for shutdown processing in

single-thread

main storage buffers fies size of buffers as 64 words

a threshold value of 5 buffers 12.5%)

Gives the number ARPs to available to ICAM

Specifies type of terminals on line Gives characteristics of the line Gives port number of communications

adapter that this ine is to use TERM ADDR=(28,51), X Gives address of terminal

FEATURES=(U200, 1920) LOW=MAIN

TERM ADDR=(28,52), FEATURES={U100,960)

LOW=MAIN

TERM ADDR:::(29,53) FEATURES=(U100,960) LOW=MAIN

TERM ADDR=(29,54), FEATURES=(U100,960), LOW=MAIN

LINE DEVICE=(TTY,33), 110,SWCH), CALL=5424100

Identifies terminal as UNISCOPE 200 with screen size of 1920 characters Creates queue to be used th main

storage buffers

X Gives address of terminal 2 Identifies terminal as UNISCOPE 100

with size of 960 characters Creates queue to be used with main

storage buffers Gives address of terminal

X Identifies terminal as UNISCOPE 100

)(

X

x

)(

with screen size of 960 characters Creates low-level queue to be used

with main storage buffers Gives

Identi with

100 size of 960 characters queue to be used with main

buffers

1 of

1907 1

UP-11907

Explanation

10 16 72

---//---

TRM5

LNE3

TRM7

TCIDTF

TERM FEATURES=(TTY) LOW=MAIN

DEVICE=(UNISCOPE),

TYPE=(2400,SWCH,SYNC,UNAT) 10=06

TERM ADDR=(29,51), FEATURES=(U400, 1920) LOW=MAIN

TERM ADDR=(29,52),

FEATURES=(U400, 1920), lOW=MAIN

DISCFI MSGSIZE=1920

ENDCCA

Identifies terminal as TELETYPE Creates queue to be used th main

storage buffers

x fies

Gives address of terminal X Identifies terminal as UTS 400

screen size 1920 characters Creates queue to be used th main

storage buffers Gives address of terminal Identifies terminal UTS 400 wi

screen size of 1920 characters Creates queue to be used th main

storage buffers

Identifies file to be used for input buffer; maximum message size is 1920 bytes.

Ends ICAM defini

(Part 2 of

IMS

ICAM

UP-l

113 16 72

MEDIUM=MAIN, LOW=DQFILE1

HIGH=MAIN, X

MEDIUM=MAIN.

LOW=DQFILE1

X

HIGH=MAIN. X

MEDIUM=MAIN.

LOW=DQF LE1

X X

HIGH=MAIN, X

MEDIUM=MAIN, LOW=DQF LE1

Explanation

Creates high-level with main storage Creates medium-level

with main storage

used to be used Creates low-level queue to be used

th disk file buffer

Creates high-level be used with main storage

Creates medium-level to be used th main storage

Creates low-level used with disk file

Creates high-level with main storage

Creates medium-level to be used with main storage

Creates low-level be used with disk file

Terminal has communications output printer

Creates high-leveL queue to be used with main storage buffers

Creates medium-level to be used with main storage

Creates low-level wi th di sk file

Unsolicited ^{(P~rt \1} c.JIB\,.Ii. ^{1 nf?\} VB "-I

UP-l

HIGH=MAIN,

lOW=DQF

P001 le

TERMINAL 2 IUNISCOPE

1001

ICAM

COMMUNICATIO~IS OUTPUT PRINTER

TERMINAL PRINTER

sessions

1

Explanation

fies TRM1 session

terminal

TRM2 as static session TRM3 as a static

TRM4 session

as a process

UP-l

STATIC SESSION TERMINALS

a

IMS

ICAM

DISK QUEUEING

FILE

DYNAMIC SESSION TERMINALS

Communications Network

.... ^~~.-,~~ 2-9 and 2-10 illustrate a network that uses three local workstations and one remote workstation. Notice in the network definition that there is one local workstation per line. The remote workstation has a screen device that is defined to ICAM as a terminal. Both terminals are on one line and form one

IIJVJLlJU.Jl~ group.

This network three other in addition to the TCAM

standard interface. One of the local is defined in a SESSION macro as a static terminal for CUPP and is not available to IMS. The other three workstations are terminals and can be attached to IMS or any of the other

cn·"."T\" .... t unsolicited or continuous

unsolicited and continuous it would the

"'..-.." ... .." ... on the CCA macro, three queues for each session with IMS.

---//---

LNE4

LBL=1000

DEVICE=(RWS) TYPE=(9600,SWCH,

FEATURES=(U40, SECONDARY) ADDR::::(28,52),LOW=MAIN, HIGH=MAIN,AUX1=(COP,73)

,EU2=(TRM1

,EU2=(CUPP)

x

Defines Local

Explanation

n",nn'-"'m using interface

using the

terminal on as

LNE2 as

line

terminal and creates is

TRM2. TRM3, and IMS.

fies polLing group

Specifies that the communications line LNE4 uses remote workstation protocol

fies the remote workstation is the primary screen of a UTS 40.

Ident fies address workstation in l group

Specifies that the remote workstation is a UTS40 screen bypass device.

Identifies address of screen bypass device in polling group

Identifies TRM1 as static session terminal for CUPP

ldent i ties PRF1 as a stati process file for cupp

UP-l

CUPP

STATIC SESSION TERMINAL

IMS

SINGLE LINE COMMUNICATIONS

ADAPTER

CUPN

DYNAMIC SESSION TERMINALS

2-12 illustrate a

DISK BUFFER

FILE

CUPO

prOCE~SS,lnlg-. The network contains can route

transactions to the other for or process transactions it receives from the other. 2-11 illustrates the definition of the and

I,,"'-I-.... n-l-,..." the definition of the "'''' .... 'v .... ' ...

Macro Explanation

16 72

---11---

IMS9

TYPE=(GBL"NODA)

FEATURES=(OUTDELV,OPCOM), X PASSWORD=IMSNET01

GAWAKE=YES, SAVE=YES,

DCA=YES Indicates

BUFFERS 100, 1 ARP=50,

LINKPAK=(50,80,10)

LOCAP TYPE=(TC I LOW=MAIN MEDIUM=MAIN, HIGH=MAIN

LINE DEVICE=(UNISCOPE).

TYPE=(2400,SWCH,SYNC) CALL=3589

TERM ADDR=(28,51 , FEATURES=(U100,960), HIGH=MAIN,

MED IUM=MAI N, LOW=MAIN, INPUT=(YES)

TERM ADDR=(28,52) FEATURES=(U100,960) HIGH=MAIN,

MEDIUM=MAIN, lOW=MAIN INPUT=(YES) TERM ADDR=(29,53)

FEATURES=(U100,960) HIGH=MAIN,

MED IUM=MAI N, lOW=MAIN, INPUT=(YES)

X

X X

x

X

X

X X X X

Specifies the number of 80-word ink buffers used with distributed data processing and threshold value

fies the telephone number used al a terminal

Creates an input message queue for this terminal

Macro

10 16 72

---1/---

TRM4 TERM ADDR=(29,54),

FEATURES=(U100,960) x

HIGH=MAIN,

MEDIUM=MAIN, x

LOW=MAIN, INPUT=(YES) LNE6 LINE DEVICE=(UNISCOPE).

TYPE=(9600,SYNC)g 10=15

TRME TERM ADDR=(28,51).

FEATURES=(U200,'920) x

HIGH=MAIN,

MEDIUM=MAINg x

LOW=MAIN, INPUT=(YES) P001 PRCS LOW=MAIN

SESSION EU1=(IMS9) x

EU2=(P001)

V3N1 VLINE DEVICE=(ABM,PRIMARY),

10=10, x

TYPE=(9600,FlDQ), x

CMADDR=3,

RSPADDR=1

Network Definition for Global ICAfvi

(Prim!:!!I'"'' Clom[mte~r} (Part 2 of 3)

Explanation

Creates a process file for temporar;

storing messages

macro

the name of a local end user in the label of a LOCAP

Specifies the name of a local end user defined in the label of a PRCS Specifies this tine is used for

communication between two 05/3 systems and that this processor is the primary computer

Identifies the line number of the line communications adapter Specifies the line speed

Specifies the universal data ink control frame level address used to transmit commands and receive responses

Specifies the universal data link control frame level address used to transmit responses and receive commands

irH''tn.ii'1'ltiIO Distributed Data D .. ,,,,",,",,,,,,,,,,,,o

10 16

---//---

IMSR

lPORT EU1=IMS9,

EU2:::IMSR

USERTP=STDMCP,

CATP:::C,

LINE=V3N 1, REMOTE=NODB, PORT=4,

RWNDW:::2 lOCAP TYPE:::(TCI)o

REMOTE:::(NODB)

ENDCCA

Explanation

the destination number

port

The name where this

72

---11---

,NODB)

FEATURES=(OUTDELV,OPCOM) X PASSWORD=IMSNET01

GAWAKE=YES,

)

FEATURES=(U400, 1920) MED IUM=MAI N,

INPUT=(YES)

FEATURES=(U400,1920), HIGH=MAIN,

MED IUM=MAI N,

X

X

LOW=MAIN, X

INPUT::::(YES)

FEATURES=(U400,1920) X

HIGH=MAIN, MEDIUM=MAIN, LOW=MAIN.

INPUT=(YES)

X

FEATURES=(U400,1920), X

HIGH=MAIN. X

MEDIUM=MAIN. X

lOW=MAIN.

INPUT=(YES)

Explanation

Macro Explanation

10 16 72

1 / - lNE6 LINE DEVICE=(UNISCOPE), X

TYPE=(9600,SYNC), X

ID=15

TRME TERM ADDR=(28,51), X

FEATURES=(U400, 1920) X

HIGH=MAIN, MEDIUM=MAIN, LOW=MAIN, INPUT=(yES) LOW=MAIN

EU1=(IMSR) X

EU2=(P001)

VLINE DEVICE=(ABM,PRIMARY) X ID=05,

TYPE=(9600.FLDQ),

CMADDR=1, X Specifies universal data l control

frame level address used to transmit commands and receive responses

RSPADDR=3 Specifies universal data link

frame level address used to transmi responses and receive commands LPORT EU1=IMSR, The label of the LOCAP macro

the Local end user

EU2=IMS9, X The label of the LOCAP

the remote end user

USERTP=TCI X

CATP=C, X

LINE=V3N2^e X The label of the VLINE macro REMOTE=NODA, The name of the destination node

PORT=4, X

RWNDW=2

IMS9 LOCAP TYPE=(TCI) • X

REMOTE=(NODA) The name of the remote node

where this tocap ENDCCA

Definition for GlobailCAM Distributed (Part 2 of 2)

Several methods are available to the action programmer for

and messages at remote terminals. The most convenient of these eVllce'-lnaepelnalent control and field control characters DICE and FCC sequences in message text are detected and pr()CeSSEld

"'"n,",,,,i'H A,rhi-"",n' of messages to the and

""'...", .. "' ... ",,11-,.., ... '" in the ACTION DICE and FCC sequences

messages before are to your action program .

... o;;;;- ... U.o;;;~o;;;;A ^... U.~;,U.1.J control is

sequence inserted into text of an message remote terminal devices. DICE functions

have UTS terminals or local in your you can use control character sequences your action program your UTS .,.., .... ",...,..., FCC is a hexadecimal sequence that with the character US

It is similar to DICE but additional control over data torm2ttting. With FCC sequences in the message, your program can ^{A,U ••} "J..U.A"' ... "

selected elements of data to the wrong of data or .".. ... ,Y<7.n,,..,

~~~'_~4",~ of any data in a field. You may also use FCCs to

cn~ln~~ea or variable data be transmitted.

annr()Dl'ia1te reference A ... U ... U .... u..

' ; / 4 , l . l l l A . l . messages sent to a console

not edited. Most and sequences are as tJU,r.lI.f< .. ' L

but in a as characters on the console screen.

UP-l

to:

h ('\1:11701,7011" you can still execute the

of records

allows you to:

is not DO:SSIIOle

the ZP#NRU you must include INIT control stream. Its format is:

BLKSZE=nnnnn

the IUllct~lon nal:-arrletE::;r

... "' ... rnntT from

control ",1-"''''<>1''''"'

PASSWORD

TID::::

PASSWORD

definition in which accesses is defined. The name of the same as the defined file name.

FN=def· lename

Identifies the defined file or subfile to which this n~CC":H(,\"'I'rI ... .., ... "' ... ""'-,,'" access.

TID=ALL

Ut,dlIJUU.U'''>;J<:) that all terminals .... ""~ .... h',.,.," .. o r l

DELETE

DelETE

Record

UP-l

include the format:

names should not

should not exceed

A.l.UILlUllCU . .I..fi. character in column

any column

3-9

LFD

DELETE P::iW=WAI<!::::S

The statement the nass\I\lQ1'd statement lists the

of all records in the NAMEREC file.

necessary

scratches and any or

NAMERECand

online

IMS internal This IMS#NTZ

rl"""·o1-,, ... program and NI>1no, .. ",t- records in the NAMEREC file.

functions:

the

Functions Performed

Links the user communi- cations control area (CCA) into a load library file

Initializes (or scratches reinitializes) IMS 90 internal files

Control Stream Generated the

IMSCONF

Linkage Step

IMS#NTZ

Files Affected Remarks

You may define user files in place of SY$OBJ and SY$LOD.

The network load module is placed in the file containing the configurator load modules.

Functions Performed

Executes the sonfigura- tor and generates records for the NAMEREC file

Assembles user DTFs or CDIB/RIBs and IMS program

Links IMS and DTFs or CDIB/RIBs into an executable IMS system and places system in a

library file

1

Control Stream Generated by the

IMSCONF jproc

Configuration

I'icCQ.Tlhhl Step

Online Module Linkage Step

Files Affected Remarks

The IMSSASM and IMSSLNK source modules may reside in SYSSRC or in a user-defined

Input for the configu- rator may be in the same source

or in the card reader.

The OS/3 system scratch fi Ie SSCR 1 is used by the

AUDCONF

User-defined files may replace SYSSRC and SYS08J.

The user may define source, object, or load library files in lieu of SYSSRC, SYS08J, or SYSLOD.

4-4

or enter

c. Place II FIN

3. Run corlti~rurat(.r

a.

c.

use card

them with a the

At least of

UP-l

/ / FIN

/ / IMSCONF

/ / IMSCONF

a. Configuration Job Decks with no ALTER

CONFIGURATOR SECTIONS

b. Configuration Job Decks when ALTER Job Control Statements Are Used

INPUT DECK FOR IMS CONFIGURATOR

To run your IMS i'>('\'I'"lTHTll'W-<;I from a workstation

1. the

param(;;ter of the IMSCONF UP-9976.

'-" ... ,,, .... ,, ... ,, the control stream:

Select IMSCONF the

c.

the command

and file it in the Refer to the General

the Interactive Services

stream file it the

UP-l Rev. 1

Enter input.

Build job control stream.

Run job.

Configurator Sections

/ / JOB / / IMSCONF

/&

/ / FIN

area

if internal files are

l

le-

(continued)

UP-l

(continued)

Multithread only

Single-thread only

-audit-fi -statfi

-audconf-fi -statfi

)

[ LOADM= online-load-module-name]

[,SWPRI=priority]

(

The £l"nUA"'ri p,aralmE~te]rs control the aSS;igrlmlent offiles to and load libraries needed the ",..."~.f.~r,""",,,,4-... , ...

of the It must also

Because these modules must be

.,~rln·l-",rI to the OS/3 release level

from the IMS -- the online IMS load goes to the file indicated on the ZCNF

illustrates functional sequence

to be coded. The same sequence is fonowed in the sut)SelaUE~nt

which describe each and its functions. """V'l.U . .llli:;;;.

UP-11907 1

DEFAULT:

CDM MODE

YES

YES

YES

YES

YES

YES

SPECIFY DEVICE, VOLUME, AND LIBRARY NAME

(LlBS)

SPECIFY DEVICE, VOLUME. AND LIBRARY NAME

(LlBO)

SPECIFY DEVICE, VOLUME, AND LIBRARY NAME

(LlBL)

DEFINE SOURCE MODULE NAME

(INPUT)

SPECIFY LISTING OPTIONS (LST)

(Part 1 of 3)

4-13

OS3REL

DEFAULT RUN ALL CONTROL STREAMS*

OS3REL

YES

YES

YES

YES

YES

SPECIFY TYPE OF CONFIGURATION

(lCNF)

SPECIFY LOCATION OF CONFIGURATOR

MODULES (ZCNF)

SPECIFY JOB CONTROL STRFAMS

TO BF: RU!\J (CNFJCS)'

SPECIFY CCA NAME

(CCA)

SPECIFY LOCATION OF

CCA OBJECT MODULE

(CCA)

*Does not apply to IMS#INT control stream, which is governed by the INIT keyword parameter.

ON SYSRES

DEFAULT:

NO INITIALIZATION

DEFAULT:

NO ALTER STATEMENTS

NO

SPECIFY VOLUME(S) AND NAMES FOR YES NAMED RECORD,

YES

YES

AUDIT, CONTINUITY DATA, AND STATISTICAL DATA

FILES (lMSFIL)

SPECIFY TYPE OF INITIALIZATION

(INIT)

SPECIFY ALTER=YES

SPECIFY BLOCKSIZE AND NUMBER OF

BLOCKS FOR NAMEREC, OR NO INITIALIZATION

DEFAULTS:

3072 6144

SPECIFY NUMBER OF CYLINDERS

FOR STATFIL

10

InCUC8ltInlg a

default value.

source

is

· l

SYSRES

VOlurrle c()nt:alnlng the

~~vu"~~.IMSCONF a

ret)reSel1ts the release level.

is

is reader is the default

UP-l

NAMEREC CNF - ID 0001 0009 0022 0105

Notes:

Conf

Configuration system.

Configurator

The may must

uniquely section

time-keeping

LST

c Lists

s

If the

mUlltlt;hr,~ad IMS ",,,,,,,;hc>"lI'n

IMS QVQ.1"t:lITn

IMSF I Un]::

vsn

IMS 1 named record file

statistical data

"-'..,,~"" .... _ ... '" that the SYSRES. This is

is

this paralnelcer

file. The default is

~ul)paralltletier 4:

SPE:~ClIlea. for

The is

the statistical data file identifier

72

UP-1l907

modules.

-audconf-

.'-.LA.U,"''''UI.I....,'''' in SU1)PflramE~teJrS

72

a1l()Ca1tea. for

the

a task

see

up:

::::

Given:

+

=

,CCA,CNF) IMSFIL=(51,DISK08),INPUT=IMSSRC.

lOADM=IMS01 CCA=(IMS1

indicates the

72

modules

1

No conlfigura,tor

UP-1l907 Rev.

x

network

1

GENERAL

AUDITNUM

CHRS/LIN length

DDPBUF

DDPSESS Specifies number DDP

sessions that can active iNBUFSIZ

LNS/MSG Specifies

MAXCONT

TRANLEN

x

UCHAR

x

CONTOUT

UP-1l907 Rev.

x

INTLIST x x

MSGPOS

RECOVERY

RESEND

4-44

Provides support for downline a

Allows IMS DMS

use of fast feature Specifies inclusion of file updating modules in IMS

Allows interruption output

from LIST command

Provides capability of clearing screen of unprotected and protected data

Provides capability of dislpla){ing messages at top or bottom of screen

Provides support for console transaction .,",,,,,,,,,<,,,,i.,,.,.

Allows actions

locking across

':::'DE!CIW[,!S recovery this IMS configuration

for

Specifies of

support ZZRSD terminal command

Specifies maximum number screen formats to remain resident between screen format services calls

continued

UP-11907 Rev. 1

Table Parameters to IMS

Multithread

IMS Remarks

OPTIONS RESMEM the number

(cont.) transaction buffers, the

maximum number transaction buffers acquired from IMS storage pool, and the maximum of transaction buffers a transaction can acquire

RFMTONLY X Specifies RESFMT

Value is used to determine total number of resident formats.

SFS X X Provides support for screen

format services

SNAPED X whether

STATS X X Specifies recording

statistical information at shutdown time

SUBPROG X Provides support for user-

written

TOM FILE X Specifies that terminal output

messages are written to the TOM FILE for online recovery

TOMTRCE X Specifies that terminal output

messages written to the TOM FILE are also written to trace file for use in offline recovery

continued

UP-11907 Rev. 1 445

OPTIONS (cont.)

TIMEOUTS

UNSOL

ACTION

STATUS

file-name FILETYPE

CAFILE

Sections

x

x

x

x

unsolicited output (SEND function,

NOIlrel)eatable section Specifies maximum time action

may

Specifies

31.Jtomatic status message terminal multithread

storage

x

terminal-id

x

IMSREADY

x

repeatable section Positional parameter specifying ID of terminal described subsequent kp\MJnrrlc:

whether terminal is to receive the IMS READY message at start-up time

continued

TERMINAL (cont.)

TRANSACT

Sumnnarv of Sections and P!:l!Ir'!:l!U'll'llllltlllll"l:

MASTER

STATUSMG

UNATIEND

UNSOl

URGENT

trans-code

ACTION

Single-Thread IMS

x

x

x

x

Multithread IMS

x

x

x

x

Specifies this terminal in the

-.)1 .. 11::;\.,111':;;;:) whether status

messages by IMS

timer the terminal are suppressed

::>PE~Cltl~as whether terminal is unattended

SPE~cltlles whether this terminal is to receive notice

unsolicited output at the end of an action or a transaction Specifies whether all messages

from this terminal have urgent priority

may be omitted if user has no transactions to describe, in which case the

of OPTIONS

must be coded once for each transaction

Positional parameter; required to transaction code to configurator

SPE~clf!~as name of program to be scheduled this transaction

continued

UP-1l907 Rev. 1