CMS LEVEL 7 (OPR. INSTRUCTION FOR CMS)

• Document Type: CREST
• Collection: NGA Records (Formerly NIMA)
• Document Number (FOIA) /ESDN (CREST): CIA-RDP94T00858R000601000001-2
• Release Decision: RIPPUB
• Original Classification: K
• Document Page Count: 33
• Document Creation Date: December 28, 2016
• Document Release Date: February 12, 2008
• Sequence Number: 1
• Publication Date: April 13, 1983
• Content Type: REPORT

Approved For Release 2008/02/12 : CIA-RDP94T00858R000601000001-2
DATA CENTER OPERATIONS BRANCH
NDS OPERATIONS PROCEDURE MANUAL SYSTEMS SW & HW
NO. P-0005 13 April 1983
CMS LEVEL 7 (OPR. INSTRUCTION FOR CMS)
SYMBOLIC TITT.F' N/A
ORIGINATOR:
STAT
Approved For Release 2008/02/12 : CIA-RDP94T00858R000601000001-2
 Approved For Release 2008/02/12 : CIA-RDP94T00858R000601000001-2
Iqu M
Fl- r- nit 5-
. ~7/~ S z evj ?
PSG/CSD/PB-024/82
26 May 1982
MEMORANDUM FOR: Chief, Data Center Operations Branch, CSD/PSG/NPIC
FROM STAT
Chief, Progralnm.ng Branch, CSD/PSG/NPIC
SUBJECT : Operating Instructions For CMS
1. Attached is Section 2 of the CMS Operator Reference Manual (UP-8745)
that we have annotated for our specific use at NPIC. We have also crossed out
those portions of the document that are not applicable here.
2. Please make the appropriate changes to all copies of the document that
you hold.
STAT
Approved For Release 2008/02/12 : CIA-RDP94T00858R000601000001-2
 I r 6'C I Icr s r..f
Approved For Release 2008/02/12 CIA-RDP94T00858R000601000001-2 --- `oecE
~% IL
2. Operator Reference
2.1. General Description
2.2. Using CMS
2,2.1. Starting CMS
2.2.2. CMS Consoles
2.2.2.1. Series 1 100 Operator's Console
'' "'-ti+rec-{~4onitor~ern~inal (Remote GCS-Terminal
2-r22-2.3. T-e4Con.-C-onsole- --- -
2.2.3. Statistics
2.2.3.1. Statistics Commands
2.2.3.1.1. ST SE (Start System Events)
2.2.3.1.2. ST SD (Start System Data)
2.2.3.1.3. ST SDE (Start System Events and System Data)
2.2.3.1.4. ST ND (Start Network Data for LTT, PE, or DT)
2.2.3.1.5. ST ALL (Start All Statistics Data Collection)
2.2.3.1.6. SP Command (Stop Statistics Collection and Dump)
2.2.3.1.7. MON (Monitor) Command
2.2.3.2. FINM (Finish Monitor) Command
2.2.3.3. ST (Statistics) Command
2.2.3.4. SP (Statistics) Command
2.2.4. CMS Print File Handling
2.2.5. CMS Termination
2.2.5.1. TERMI Keyin
2.2.5.2. TERMR Keyin
2.2.5.3. TERME Keyin
2.2.5.4. Dump and Trace Analysis
2.2.5.4.1. Automatic Dump Processing
2.2.5.4.2. CMS Dump (CMSDMP Runstream)
2.2.5.4.3. No Dump Available
2.2.5.4.4. CMS Trace ((MSTRC Runstream)
2.2.6. Audit or Trace Functions
2.2.6.1. Turn Audit Functions On/Off (AON, AOF)
2.2.6.2. Control of the Audit File (AUDCLS and AUDIT POINT 0)
2.2.6.3. ' Effects of CMS Termination on Audit Functions
2.2.6.4. Analysis of Audit File
2.2.7. CMS Debugging Aids (DKEYINS)
2.2.7.1. Storage Change (DC)
2.2.7.2. Storage Snap (DS)
2.2.7.3. Inspect Storage (DI)
2.2.7.4. Snap the CMS D-Bank (DT)
2.2.7.5. Read and Execute Storage Changes From Data-File (DR)
2.2.7.6. Set Breakpoint Address (SB)
2.3. CMS Network Control Functions
2.3.1. Using CMS Network Control Functions
2.3.2. GCS Functions
2.3.2.1. GCS Command Format
2.3.2.2. General Error Messages (GCS)
2.3.2.3. GCS Operator Keyins-Explanation of Each Command
2.3.2.3.1. /NFS LTn (Display Network Facility Status of LTT)
2.3.2.3.2. /NFS PE alb (Display Network Facility Status of PET)
2.3.2.3.3. /NFS DT p, (Display Network Facility Status of PID)
2.3.2.3.4. /DWN LT n (Down and Free LTT)
2-2
2-2
2-3
2-3
2--4
2-4
2-5
2-6
2-6
2-6
2-6
2-7
2-7
2-7
2-8
2-8
2-9
2-9
2-9
2-9
2-9
2-10
2-10
2-10
2-11
2-11
2-1 1
2-12
2-12
2-13
2-14
2-14
2-15
2-15
2-15
2-15
2-16
2-16
2-16
2-16
2-16
2-17
2-17
2-18
2-18
2-18
2-18
2-19
2-19
Approved For Release 2008/02/12 : CIA-RDP94T00858R000601000001-2
 Approved For Release 2008/02/12: CIA-RDP94T00858R000601000001-2
j
`~
"~'~t~-3
v ~E
~
_.
--_
W
-------- -- --
.__.
----
2.3.2.3.5. /ACT LT n (Assign and Activate a Line)
2-20
2.3.2.3.6. /DNP PE a/b (Do Not Poll PET)
2-20
2.3.2.3.7. /RSP PE alb (Resume Polling on PE)
2-20
2.3.2.3.8. /HLD DT p1 (Hold Output to PID)
2-20
2.3.2.3.9. /HLD PE alb (Hold Output on PET)
2-21
2.3.2.3.10. /REL DT pi (Release Output Hold on PID)
2-21
2.3.2.3.11. /REL PE alb (Release Output Hold on PET)
2-21
2.3.2.3.12. /INH DT p7 (Input Hold on PID)
2-21
2.3.2.3.13. /IRL DT p7 (Release Input Hold on PID)
2-22
2.3.2.3.14. /ALT DT pi TO P2 (Alternate Address for PID)
2-22.
2.3.2.3.15. /RST DT pi (Resume Traffic on PID)
2-22
2.3.2.3.16. /MSG DT pi (Message Count on PID)
2-23
2.3.2.3.17. /MSG (Outstanding System Output Messages)
2-23
2.3.2.3.18. /DEL DT pt m (Delete Messages from PID Deferred Queue)
2-23
2.3.2.3.19. /CHG TO p, (Change Network Monitor PID)
2-24
2.3.2.3.20. /USECLT devname 1 , devname2 (Change CLT Assignment)
2-24
2.3.2.3.21. /CPP PE alb TO j,k,l (Change Polling Rate on PET)
2-24
2
-
I
-N
k
F
i
.
,. e
con
etwor
-
unct
ons - - - -
2-25
2
3
3
1
T-
f
G
f
d
-2
.
-
.
.
con--
omman
e
-
ormat -
f
M
2
3~- G
&
T
l
enec
irer---
.
-
essages-{
con)----
e
---------
-~
333--Operetor-4 eyins-Ex
2-
lanation-of-Each-Telc
--C
d
.
p
on
omman
-
2-2
9-
UP-fep, -c-hannel,-net, -port-or-session
-2-26
IDGW --
2
/
h
i
v
-FREE-eh
2
3
3
3
3
p-e
af ne
,-por-t,-or-sess
on---{0)
R
l
.
-
.
.
.
'
e
-
2
93
4
h-o
3
S t
M
4!{~
f#
3
.
.
-
-
e
ne-er-
ec-e
s-
o-a-0i
erent-FEP (S~A/3
2
-2-6
22
3
3
3
6
Staws ef
af~f~$l
nst
rt--
-
i
S
.
.
.
.
.
-
po
er
sess
on- (L
}
2-
29
2
-
1-
EEO--T-1MMi EOUT
t
.
on
(
}
fo
2-
2.4. GCS/CTMC/CSP Commands
2.5. Summary of Telc,on Commands
2.6. GCS Commands Usable on Telcon Entities
3. Programmer Reference
3.1. Introduction
3.2.
CMS Elements and Their Organization
3-1
3.2.1.
Special Elements
3-1
3.2.2.
Activities
3-2
3.2.3.
Overlay Structure
3-2
3.2.4.
Message interfaces
3-2
3.2.5.
Applications Program Interfaces
3-2
3.2.6.
Communications Hardware Interfaces
3-3
3.2.7.
Table Structure
3-3
3.3. CMS Programming Conventions
3-4
3.4.
Device Handler Development
3_4
3.4.1.
Introduction
3-4
3.4.2.
Line Initialization
3-6
3.4.3.
Line Termination
3-6
3.4.4.
System Facilities Check
3-7
3.4.5.
Input/Output Selection
3-8
Approved For Release 2008/02/12 : CIA-RDP94T00858R000601000001-2
 8 74 5.1
UP-+,UNBER
Approved For Release 2008/02/12 : CIA-RDP94T00858R000601000001-2
-1
%-IVIO llpeIdluf neIt;IUIK.C UPDATELEYEI PAGE
2. Operator Reference
tive System to communicate remotely with a variety of computer users. CMS runs a user
Communications Management System (CMS) is a program designed to allow the Series 100
in the real-time mode, and handles messages between the Series 1 100 Exec ve System
devices.
channels. See Figure 2-1 for a di
C,~IANNEL2
Approved For Release 2008/02/12 : CIA-RDP94T00858R000601000001-2
2.1. General Description
The communic
ions devices handled by CMS are logically grouped as a hierarc
network. At the
sessions are called
west level are devices or sessions (for example, a sing
its in Telcon networks and Poll Entities in GCS net
Poll Entities are known
more NETs are controlle
s Lines in GCS networks and NETs in Telco
y small dedicated computers called Fr
FEP uses one or more physic
al communications
terminal). Groups of
'orks. Groups of ports or
etworks. Groups of one or
End Processors (FEPs). Each
 -1 jo
PAGE
ur-w:-ti Approved For Release 2008/02/12 CIA-RDP94T00858R000601000001-2 ._. i ` Q,'E LEVEL
1W_ M
Thte-operator-starts and stops CMS, turns on statistical collection and trace functions;--and-conto4
tie-state-of the-network-by-upping and downing FEPs or channels, switchin94jr-oups-of-de+44c 'ror
one-F-EP-to--another,-and -manipulating message-queues.
2.2. Using CMS
2.2.1. Starting CMS
CMS may be started in any of the ways available for starting user programs: by ST keyin on th
operator's console, batch runstream, etc. It may be convenient to start CMS automatically from th
system initialization runstream. The method of starting CMS may vary from site to site, and loci
operational procedures should be consulted. However, Sperry Univac does provide a standar
runstream for starting CMS. When this method is to be employed, CMS may be started by the keyir
TILE
ST qual *if-T4L T-Y.CMSRUN,n,run-id,account-number or Srr CM 5 (a} nIPIC~
If n = 1, the recovery file is reinitialized (recovery not attempted). If this field is blank, recover
is attempted. If the run-id field is blank, the run-id defaults to CMS7.
When CMS acquires real-time status in the system, the CMS sign-on message, containing the CM
level designation, start date, and time, is displayed at the system console. If the CMS audit functio
is present (see 2.2.6), the audit file initialization message is then displayed. If debug code is turne
on, the following message appears:
When the operator responds with 'GO', CMS initialization of CTMC, GCS, or C/SP lines (or('--Ps i
Telcon systems) takes place. If any CTMC, GCS, or C/SP line in the CMS configuration ca...ot b
assigned or initialized (excluding dial-up lines) the following message is displayed:
COULD NOTsJNIT LTT nnn ssuu cc (EXEC Level 33 or earlier)
COULD NOT INIT LTT nnnxxxxxx (EXEC Level 35 or later)
where:
nnn is the line number in the CMS configuration
ssuu is the subsystem and unit number of the line
cc is the C/SP number, zero if not a C/SP line
xxxxxx is the absolute device name used to assign the line
Following the CTMC, GCS, or C/SP line initialization, Telcon FEP initialization is started. For each FE
that is marked down (DN) in the CMS configuration, the following message is displayed:
fepname IS DOWN
For each FEP that is marked 'UP' in the CMS configuration, CMS initialization attempts to assign
channels connecting this system to the FEP. If at least one channel is successfully assigned per FE
CMS attempts to initialize the Telcon software in the FEP, if the FEP is already loaded and runnin
When this initialization is successfully completed, the following message is output:
fepname INITIALIZED ON CHANNEL channel-name
Approved For Release 2008/02/12 : CIA-RDP94T00858R000601000001-2
 b72, `n3 ...
ST ND PE a/b, c/d, elf ...
ST ND DT pY, P2, P3 ???
Approved For Release 2008/02/12 : CIA-RDP94T00858R000601000001-2
 6745.1 Approved For Release 2008/02/12 : CIA-RDP94T00858R000601000001-2
UP-++UYeca 1 CMS Operator Reterence_ u?..TE LEVEL
Number of messages received
Number of messages sent
Number of resends
Number of retransmits
2.2.3.1.5. ST ALL (Start All Statistics Data Collection)
The ST ALL command turns on as many statistic collection flags as possible, limited only by the
amount of allocated buffer space. Buffer space for statistics collection is allocated via the STATS
SGS at system generation time.
2.2.3.1.6. SP Command (Stop Statistics Collection and Dump)
SP ------
The SP (in place of ST) command followed by one of the above keyins stops statistics gathering for
that particular parameter. It will also cause the current statistics values to be dumped.
2.2.3.1.7. MON (Monitor) Command
The syntax of the MON. command is as follows:
JSD
MON SE
SDE
The fields of this command are separated by one or more spaces. The second field selects one of
the global CMS statistics categories, SD, SE, or both. A minus sign (hyphen) in this field indicates
a null. The third field is an integer decimal number. This is the number of seconds between monitor
outputs to the system console. The monitor output contains a heading line, SD, SE, both categories
of statistics, or just a heading line. This header gives the elapsed time since the last monitor output
and the average input and output total messages per second in this period. Note that all counts are
reset to zero at the beginning of each monitor period, so that the figures given represent activity in
that period only. The minimum allowed frequency of monitor outputs is 20 seconds; any lower figure
entered is rounded up to 20 without comment. The maximum is 262,143 seconds; any higher figure
may yield unpredictable results.
For example:
MON SDE 60
Requests output of SD and SE statistics' every 60 seconds.
MON - 30
Requests change of output frequency to 30 seconds, without changing the output
categories. If no categories are currently reporting, the header line only is output every
30 seconds.
The third field, giving number of seconds, is an optional field. When absent, the MON command is
a request to output the specified category immediately. In this case, it is not repeated, since no repeat
interval is given.
Approved For Release 2008/02/12 : CIA-RDP94T00858R000601000001-2
 Approved For Release 2008/02/12: CIA-RDP94T00858R000601000001-2
For example:
MON SE
- "'lTE LEVEL TLSE
Requests immediate, one-time output of SE statistics.
Requests immediate, one-time output of the monitor heading line.
2.2.3.2. FINM (Finish Monitor) Command
The syntax of the FINM monitor command is as follows:
SD
FINM SE
SDE
The fields of this command are separated by one or more spaces. The second field selects one of
the global CMS statistics categories, SD, SE,, or both. This command requests termination of the
periodic monitor outputs to the system console. This may be done on an individual statistics category
basis. Complete cessation of all monitor outputs is requested by the command FINM with no second
field.
2.2.3.3. ST (Statistics) Command
The syntax of the statistics command is:
LT n 1,n2,n3...
ND 1 P E alb, c/d...
DT p 1,p2,p3...
The function of this command is to reset the statistics counters to zero in the categories specified
in the second field. Note that the Network Data statistics counters are maintained in CMS system
buffers and that these buffers are allocated to the entities specified, if these activities are not already
maintaining statistics. There is a limit, set at system generation time, on the maximum number of
GCS or C/SP network entities that may gather statistics at any one time. If this limit is exceeded for
any entity type, a warning message is output, and command processing is terminated.
Approved For Release 2008/02/12 : CIA-RDP94T00858R000601000001-2
 6745.1
VP-NUYBtP
I .- I
Approved For Release 2008/02/12: CIA-RDP94T00858R000601000001-2
I _ 1-4% - - - - - - - _ , - -
2.2.3.4. SP (Statistics) Command
The syntax of the statistics print command is:
SD
SE
SDE
ND
LT
P E
n l,nZ,n3...
alb, c/d...
DT
p 1,pZ,p3...
2-9
TE LEVEL PAGE
The function of this command is to print out the values of the statistics counters of the categories
specified. The Network Data category statistics counters named in this command are also terminated
by this command. Note that the SD and SE categories are permanently enabled, and are not so
affected. The keyword ALL requests print of SD, SE categories and all counters of Network Data
category enabled at the time, and is used to reset counters to zero in the SD, SE categories and for
as many ND entities as the system generation maximums for these entities will allow. All Network
Data statistics gathering enabled at the time is thus terminated by such a command.
2.2.4. CMS Print File Handling
The BRKPT keyin has the format:
II run-id BRKPT
This closes off and prints the current CMS print file, and starts a new print file. If BRKPT keyin is
not used, there will be one print file for each CMS run.
2.2.5. CMS Termination
2.2.5.1. TERMI Keyin
The TERMI keyin requests normal termination of CMS without saving the network recovery file. It
is entered from the computer console via the 11 keyin EXEC request. The format is:
This deletes the network recovery file. Thus the next run of CMS initializes the network file. This
keyin should be used when removing a CMS with an old network which is to be replaced by a CMS
with a new network.
2.2.5.2. TERMR Keyin
The TERMR keyin requests normal termination of CMS with preservation of the network recovery file.
It is entered from the computer console via the II keyin EXEC request. The format is:
This prevents the deletion of the network recovery file. Thus when the next run of CMS is made, the
copy of the network is loaded from the network recovery file.
Approved For Release 2008/02/12 : CIA-RDP94T00858R000601000001-2
 ics i iioo I L V
~.~FEA Approved For Release 2008/02/12 : CIA-RDP94T00858R000601000001-24TE LEVEL ~~GE
2.2.5.3. TERME Keyin
The TERME keyin requests an error termination of CMS with dump and trace, with preservation c,.
the network recovery file. It is entered from the console via the II keyin EXEC request. The format
is:
Whereas the other TERM keyins cause termination to r:ommence when all other work is done, TERME
forces termination immediately. If the standard runstream CMSRUN is used to start CMS, CMSDMP
and CMSTRC are started automatically from CMSRUN following this type of termination. The network
recovery file is not deleted.
The TERM keyin (TERMI, TERMR, or TERMED is the recommended method of bringing CMS down. An
E runid or X runid keyin can hang the RSI output activity. If any terminals are in demand mode and
the RSI output activity is waiting for output then CMS is hung until it gets some output. This situation
can be remedied by:
S M site-id T
to terminate the outstanding RSI solicit for this terminal.
In addition to the above difficulties, an E or X keyin forces the termination of the entire run, so any
dump or trace processing cannot be accomplished in the same run.
2.2.5.4. Dump and Trace Analysis
2.2.5.4.1. Automatic Dump Processing
a .
If CMS has been started via the standard CMSRUN runstream, automatic dump processing on error
termination is available. When CMS is terminated via the II run-id TERME keyin or if CMS aborts
because of a fatal contingency, the dump processing is started automatically.
When CMS terminates with a fatal contingency (program logic error), the following messages are
displayed:
CMS CONTINGENCY xxxxxxxxxxxx
where xxxxxxxxxxxx is an octal code defining the contingency error. The following message is
displayed by the runstream on the system console when the CMS dump has been saved:
CMS7 MAY BE RESTARTED NOW
When dump analysis begins, the following reply message is displayed by the runstream on the system
console:
DUMP STARTED. ENTER REASON FOR DUMP
Any textual response may be entered.
Approved For Release 2008/02/12 : CIA-RDP94T00858R000601000001-2
 Approved For Release 2008/02/12 CIA-RDP94T00858R000601000001-2
2-11
PAGE
2.2.5.4.2. CMS Dump (CMSDMP Runstream)
If CMS is terminated with an E runid keyin, a dump-file is available but is not processed automatically
since the entire run is terminated. The dump file can be processed using CMSDMP, a standard
runstream located in the utility file. This runstream can be started from demand, with a card deck,
or from the system console with the keyin:
ST qua/*UTILITY.CMSDMP...account-number
The latest CMS post mortem dump is processed. If the trace file is available it is also processed. The
following message is displayed by the runstream on the system console when the CMS dump file
has been saved:
When dump analysis begins, the following reply message is displayed by the runstream on the system
console:
Any textual response may be entered.
2.2.5.4.3. No Dump Available
When CMS is terminated with an X runid keyin, the dump file is not used and there is no way to
do a dump. However, it is possible to obtain a trace file analysis at this point (see 2.2.5.4.4) if the
audit file, cycle number is known.
2.2.5.4.4. CMS Trace (CMSTRC Runstream)
Any trace file created by CMS may be processed by CMSTRC ( a run in the utility file). Trace file
analysis may be initiated at any time on any audit file cycle not currently in use by CMS (for a
discussion of audit file cycles, see 2.2.6). The current audit file cycle should be closed (II run-id
AUDCLS) before beginning the trace.
The trace analysis may be started from demand, with a card deck, or from the system console with
the keyin:
FILE
ST qua/*d f4.CMSTRC,,,account-number
This utility responds with the following message:
The operator responds with the audit file cycle number that is to be edited, or END to terminate the
utility. If this file cycle cannot be assigned, the following message is displayed:
CMSAUD FILE ASSIGN FAILED
Otherwise, the utility responds with the following message:
EDIT AUDIT-TRACE *** ANS: ALL/SEL
Approved For Release 2008/02/12 : CIA-RDP94T00858R000601000001-2
 8745.1 I SPrmit ' Utt!VAC SPriCS 1100
? UP-hUMBEU Approved For Release 2008/02/12: CIA-RDP94T00858R000601000001-2 JUPDRTt LEVEL P,cE
A response of ALL causes all audit points to be edited. If only selected audit points are to be edited
the response is SEL. A response of END %Vill terminate the utility. If the response is SEL, the 'Iity
will respond with the following message:
ENTER AUDIT-TRACE-NUMBER * * * ALL/NBR/GO
The response ALL will request that all audit points be included in the edit. A number response is
the number of an audit point (see 2.2.6) to be included in the edit. The message is repeated for each
number entered. When all the required audit points have been requested, the operator responds with
GO. The edit utility will then edit and print the audit file.
2.2.6. Audit or Trace Functions
The audit or trace function provides a running trace of the actions of CMS which is written to a mass
storage file for later editing and printing. This function is available only if CMS Trace code is turned
on when CMS is built. The operator can turn each audit point on or off and can close off the old
audit file and begin a new one. In addition, the trace functions can be operated without a mass
storage file assigned, running as an "in-storage" trace. This is useful when even the overhead of 2
blocked asynchronous I/O request is undesirable.
2.2.6.1. Turn Audit Functions On/Off (AON, AOF)
To turn an individual audit point on or off in CMS, the operator enters:
11 run-id AAON OF I xx
where xx is the number of the audit point, in decimal, from 0 to 62. If an invalid audit point tiumbei
is specified,. CMS responds:
keyin INVALID KEYIN
Otherwise, CMS responds with an echo of the operator-entered message, with time of day added
The CMS standard audit points are as follows: (Additional audit points may be present in user owr
code, tailored to individual site requirements.)
1 On an AON or AOF keyin, audit the audit flagbox location that controls which
audit points are turned on or off.
3 On a DCP channel input interrupt, trace the channel name and device status
buffer (1 100/60/80) or the channel name, external function word and interrupt
status word (non-1 100/60/80).
4 On a DCP channel output interrupt, trace the channel name, external functior
word, and device status buffer (1100/60/80) or channel-name, external functior
word and interrupt status word (non-1 100/60/80).
5 Audit the first 12 words of each input PDU at the start of network r. . oco
analysis (TSTN)
Approved For Release 2008/02/12 : CIA-RDP94T00858R000601000001-2
 8745.1
UF-NVL1BER
Approved For Release 2008/02/12 CIA-RDP94T00858R000601000001-2
C M
When CMS terminates, the following message is displayed:
AUDIT FILE CYCLE nnn IS FREE
The current cycle of the audit file may be freed, and a new cycle started at any time by the keyin
II run-id AUDCLS
CMS responds:
AUDIT FILE CYCLE nnn IS FREE
NEW AUDIT FILE CYCLE IS mmm
where mmm is 1 greater than nnn. Freeing an audit file cycle in this manner allows that cycle tc
be analyzed and printed by the trace file editor (see 2.2.5.4.4 on CMSTRC) for visual inspection.
The operator may prevent assignment of a new audit file cycle during initialization by turning on'audi
point 0."
"Audit point 0" is a special case that does not control a particular audit point in CMS, but control;
whether or not an audit file cycle is to be acquired. Thus, to change from a mass storage file trac(
to a wholly "in-storage" trace, the operator turns on "audit point 0" as shown above and then close!
the current audit file.cycle (II run-id AUDCLS). CMS responds to the closure with the single message
AUDIT FILE CYCLE nnn IS FREE
Audit file functioning continues, according to which audit points are turned on, but stores data :n mair
storage only. A nwch smaller trace will be available to the user. To revert to a mass storage file
"audit point 0" is cleared (II run-id AOF 0) and the "in-storage" mode closed (II run-id AUDCLS).
2.2.6.3. Effects of CMS Termination on Audit Functions
If CMS is terminated with an E or X keyin by the operator, the last AUDIT blocks in the TRACE D-Banl
are not written to the CMSAUD file and the dump analyst must get the last information from the PM[
or FLIT analysis dumps.
If CMS terminates via the TERMI or TERMR keyins, CMSTRACE is given control prior to issuing thi
EABORT$ or EXIT$ call for termination, at which time it puts a normal termination record (AUDIT type
63) into the buffer with two words of user data. This data is the final contents of the AUDIT FLAGBO)
and is written in the last BLOCK to the CMSAUD file.
2.2.6.4. Analysis of Audit File
The audit file is analyzed by the CMSTRACE routine, which is executed via the runstream CMSTRI
or automatically after an error termination. (see 2.2.5.4.4, CMSTRACE).
At any time during CMS execution or after CMS terminates and before it is started again the CMSAUI
file may be edited using the CMSTRACE Program (see 2.2.5.4.4).
Approved For Release 2008/02/12 : CIA-RDP94T00858R000601000001-2
 b?45.1
U~-NVMHEH
7 On a call to the CMS error message handler (CMSERR) audit the error message
handler input parameter word and the address of the error handler call.
9 When CMS sends a 'RESET' request to the DCP for a particular port, all input data
for that port is discarded until a 'Reset Confirmation' is received. This point
audits the first 12 words of each discarded PDU.
10 For terminals in demand mode or REM 1 devices, trace the input terminal PID and
the first 28 words of data sent to the EXEC, including the RSI$ packet.
1 1 For terminals in demand mode or REM 1 devices, trace the output terminal PID
and the first 48 words of output data received from the EXEC. including the RSI$
packet.
12 For terminals in demand mode or REM 1 devices, trace the acknowledgements
for data sent to the EXEC. -
15 On a DCP channel input data transfer, trace the channel name and the first 15
words of input data.
16 On a DCP channel output data transfer, trace the channel name and the first 15
words of output data.
i 30 For input batch devices using RB 1 protocol, trace the RB 1 data presented to RB 1
IN by the CSU.
I cu: .ov [nu,r r inn
Approved For Release 2008/02/12 CIA-RDP94T00858R000601000001-2 ' TE EE-VEI
--t - 1 - --- -- - ------1-- -
2-t3
PAGE
6 Audit the first 12 words of each output PDU at the completion of network
protocol building (TSTN).'
31 For input remote batch devices using RB 1 protocol, trace the NTR protocol, a
translation of this RB1 protocol, presented to NTR by RB1 IN.
32 For output remote batch devices using RB1 protocol trace the NTR protocol
presented to RB1 OUT by NTR.
33 For output remote batch devices using RB1 protocol trace the RB1 protocol, a
translation of NTR protocol which is enqueued for output.
2.2.6.2. Control of the Audit File (AUDCLS and AUDIT POINT 0)
The mass storage file assigned by CMS for storing trace data is one of a set of files called an f-cycle
set. These files all have the same name (in this case, CMSAUD), but are distinguished by different
cycle numbers. These cycle numbers range from 1 to as high as 999, but only the last 32 files of
an f-cycle set are allowed to exist at any one time. The first cycle number used by CMS for the audit
file is normally 1.
When trace code is turned on in CMS, the trace file is initialized during CMS initialization. This is
indicated by the console message:
Approved For Release 2008/02/12 : CIA-RDP94T00858R000601000001-2
 Approved For Release 2008/02/12 : CIA-RDP94T00858R000601000001-22-1
uP-7Uv9E11 UPDATE LEVEL PACE
2.2.7.4. Snap the CMS D-Bank (DT)
number DT
The D-bank, Network, Bufferpools, and COMPOOL are snapped to the print file, and the print file is
breakpointed as if the BRKPT command (see 2.2.4) had been given.
2.2.7.5. Read and Execute Storage Changes From Data-File (DR)
number DR filename (1 to 48 characters)
The SDF datafile contains the storage change cards. The format of a card is:
address from column 1 to 6
blank column 7
content from column 8 to 19
The filename is any filename acceptable to the EXEC and can include qualifier, cycle number, or keys
2.2.7.6. Set Breakpoint Address (SB)
P
WR
number SB address RW mask
R
W
When trace processing is performed automatically within the CMSRUN runstream following a CMS
fatal contingency, sr operator abort, these trace utility messages are not produced. The utiliWy wil
perform a full edit on the latest trace file.
Processing stops when the designated address is referenced by:
P = Program Register containing the address
R = Reading the address
W = Writing into the address
RW, WR = Either reading or writing
2.3. CMS Network Control Functions
There are two groups of network control functions. The GCS functions operate primarily on the
devices operated through the GCS, CTMC, or C/SP control units. Some of these functions also work
with Telcon systems sessions (devices or terminals). The second set of functions work with Telcor
entities only.
2.3.1. Using CMS Network Control Functions
Network control functions are entered from the Series 1 100 operator's console via the 11 keyin EXEC
function. The format of the 11 keyin is as follows:
Approved For Release 2008/02/12 : CIA-RDP94T00858R000601000001-2
 ,4b.1
R-nuA";ER
T :EVFL
Approved For Release 2008/02/12 CIA-RDP94T00858R000601000001-2 -.--
- - -- - -
2.2.7. CMS Debugging Aids (DKEYINS)
The Debugging Aids commands are supported by the CMS routine DKEY and only available if CMS
Debug code is turned on (see DEBUG SGS). Debugging Aids commands can be entered only from
the computer console via the II keyin EXEC request. The format is:
II run-id DKEYIN
CMS responds with:
number ENTER DKEYIN
The operator then keys in:
number command
When all DKEYINS have been entered, the operator keys in:
number END
Notations used are:
Address 6-digit octal storage address
Content 12-digit octal value of storage location
Length 6-digit octal value: length of the storage snapshot (number of words)
Mask 2-digit octal value of the breakpoint mask
Count 1-digit octal value: number of consecutive storage locations to be displayed.
2.2.7.1. Storage Change (DC)
number DC address content
The given storage location is changed, and both the new contents and the previous contents are
displayed in the form:
address contents previous-contents
2.2.7.2. Storage Snap (DS)
The locations given are snapped to the print file and the print file is breakpointed as if the BRKPT
command (see 2.2.4) had been given.
number DS address length
2.2.7.3. Inspect Storage (DI)
number DI address [count)
Displays the content of one to seven storage locations. One location is displayed if count is omitted.
Approved For Release 2008/02/12 : CIA-RDP94T00858R000601000001-2
 8745.1
Approved For Release 2008/02/12 : CIA-RDP94T00858R000601000001-2
PIDs
pr, p2 are 1 to 4 digit decimal numbers
j, k, / are decimal numbers in a range of 0-63
1 -
-18
UP04TE LEVEL PAGE
devnam is a 6-character or less device name associated with the device. This name is the
same as used in the Series 1 100 EXEC system generation.
2.3.2.2. General Error Messages (GCS)
? TABLE VALUE OUT OF RANGE - LTT, PE, or PID number could not be found in network tables.
? keyin SYNTAX ERROR - unrecognizable input
19 GCS KEVIN WITH TELCON ENTITY - LTT, PE, or PID number on last keyin referred to a Telcon
entity.
2.3.2.3. GCS Operator Keyins-Explanation of Each Command
2.3.2.3.1. /NFS LTn (Display Network Facility Status of LTT)
Displays the status of the given line (LTT) in the following format:
LTT n IS I NOT ASSIGNED
ASSIGNED ON devnam
'DO NOT POLL'-dS -SET FOR POLL ENTITIES a,b,cE
I NONE
'SPECIFIC POLL' IS SET FOR POLL ENTITIES
'INPUT HOLD' IS SET FOR POLL ENTITIES I
'OUTPUT HOLD' IS SET FOR POLL ENTITIES
'ALT-ADDRESS' IS SET FOR POLL ENTITIES
a, b, c,...
NONE
P r,P2,P3,...
NONE
P 1.P2,P3,...
NONE
P r,P2,P3,...
NONE
2.3.2.3.2. /NFS PE alb (Display Network Facility Status of PET)
Display status of Poll Entity (PET) in the following format:
STATUS OF PE alb {
'DO NOT POLL' IS f SET }
111 CLEAR
Approved For Release 2008/02/12 : CIA-RDP94T00858R000601000001-2
 b745.1
UUP-NUMBER
Approved For Release 2008/02/12 CIA-RDP94T00858R000601000001-2
Ift l u r/ t' E LEVEL
~., V- u v , ., --- ------ Wk
CMS responds with:
number ENTER FUNCTION
The operator then enters:
number command
and CMS again responds with:
number ENTER FUNCTION
When all desired commands have been entered, the operator keys in:
number END
to terminate Network Control Mode.
2-17
PAGE
GCS commands (see 2.3.2) must be preceded by a sentinel character defined at system generation
time. The system default is I. Telcon commands (U,D,FREE,S, and SW) must not be preceded by
this sentinel.
When GCS commands are entered from the specially configured GCS Network Monitor Terminal, the
11 keyin is not necessary. Any input preceded by the GCS sentinel character (default is '1) is assumed
to be a GCS command.
2.3.2. GCS Functions
GCS network control functions allow the operator to display or change the states of GCS entities (PIDs,
PETs, and LTTs), -and manipulate the message queues of both GCS and Telcon entities. These
functions may be entered from the operator's console via the II keyin (see 2.3.1) or from the Network
Monitor Terminal (see 2.2.2.2).
2.3.2.1. GCS Command Format
The general form of most GCS commands is as follows:
L TT n
command PE alb j,k,l devnam
DT p,,p2
Each GCS command must be preceded by a sentinel character defined at system generations. The
system default, "/", is used here.
The other notations are:
n LTT number
a LTT number
b PE number relative to LTT a
n, a, b are 1 to 4 digit decimal numbers
Approved For Release 2008/02/12 : CIA-RDP94T00858R000601000001-2
 Approved For Release 2008/02/12 : CIA-RDP94T00858R000601000001-2
6745.1 Si E,;L'.,,'.AC Stc"is 1100 2-20
UP.-h-WEER CMS Operator Reference UPDATE INEI PAGE
2.3.2.3.5. /ACT LT n (Assign and Activate a Line)
If n is within range the proper line initialization routine is called. This is equivalent to bringing up
a line.
The normal response is:
LTT n INITIALIZED ON devnam
The error responses are:
ACT LT n devnam DOWN
ACT LT n devnam ASSIGNED
ACT LT n devnam NOT IN SYSTEM
ACT LT n CSF$ STATUS = xxxxxx
2.3.2.3.6. /DNP PE alb (Do Not Poll PET)
If the LT number and the PE number are within range, the polling is stopped on all devices on the
given Poll Entity. This is equivalent to downing a PET.
The normal response is:
PE alb IS MARKED 'DO NOT POLL'
The error response is:
DNP PE alb - 'DO NOT POLL' IS SET
s -
2.3.2.3.7. /RSP PE alb (Resume Polling on PE)
If the LT number and the PE number are within range, polling is resumed on all devices on the Poll
Entity that do not have input hold set (see 2.3.2.3.13). This is equivalent to upping a PET.
The normal response is:
PE alb HAS BEEN ACTIVATED
The error response is:
RSP PE alb - DNP WAS NOT SET
2.3.2.3.8. /HLD DT p, (Hold Output to PID)
Stop all output to device with PID pr. All items queued for output are moved to the deferred queue.
The normal response is:
OUTPUT TO PID.p1 IS NOW HELD
Approved For Release 2008/02/12 : CIA-RDP94T00858R000601000001-2
 8745; Approved For Release 2008/02/12: CIA-RDP94T00858R000601000001-2
'SOFTWARE HOLD' IS I SET I
CLEAR
SET
{ CLEAR
J SET
1 CLEAR '
'INPUT HOLD' IS SET FOR PIDS I
P 1.P2,P3,...
NONE
'OUTPUT HOLD' IS SET FOR PIDS
P t,P2,P3....
NONE
'ALT-ADDRESS' IS SET FOR PIDS
P l,p2,P3,...
NONE
2.3.2.3.3. /NFS DT p, (Display Network Facility Status of PID)
Display the status of the device with PID p, in the following format:
STATUS OF DEVICE pj
'INPUT HOLD'. IS I SET CLEAR J
'OUTPUT HOLD' IS
J SET
1 CLEAR
'ALT-ADDRESS IS P2
{ CLEAR
where P2 is the device to which traffic is rerouted
2-
PAGE
2.3.2.3.4. /DWN LT n (Down and Free LTT)
If n is within range the proper line termination routine is called to down and free the named ling
The normal response is:
LTT n TERMINATED ON devnam
The error responses are:
DWN LT n devnam DOWN
DWN LT n devnam IS ALREADY FREE
DWN LT n devnam NOT IN SYSTEM
DWN LT n CSF$ STATUS = xxxxx
Approved For Release 2008/02/12 : CIA-RDP94T00858R000601000001-2
 8745.1
UP-NUMBER
Approved For Release 2008/02/12 : CIA-RDP94T00858R000601000001-2 UPD4TE LEVEL I PAGE
The error response is:
HLD DT pl - OUTPUT ALREADY HELD
2.3.2.3.9. /HLD PE alb (Hold Output on PET)
Output is stopped on all devices on the given Poll Entity Table (PET). All items queued for output are
moved to the deferred queue by message queueing.
The normal response is:
OUTPUT HELD ON PE alb
The error response is:
HLD PE alb - OUTPUT ALREADY HELD
2.3.2.3.10. /REL DT p 1 (Release Output Hold on PID)
Resume output to device with PID pl. All items on the deferred queue are moved to the main queue.
The normal response is:
PID p, MAY NOW RECEIVE OUTPUT
The error response is:
REL DT p, - WAS NOT HELD
2.3.2.3.11. /REL PE alb (Release Output Hold on PET)
Resume output to all devices on given PET. All items queued on the deferred queue are moved to
the main queue.
The normal response is:
OUTPUT MAY BE SENT TO PE alb
The error response is:
REL PE alb - OUTPUT WAS NOT HELD
2.3.2.3.12. /INH DT p, (Input Hold on PID)
Throws away all input from the device with PID pt . Messages will not be selected for output if inpu
hold is set.
The normal response is:
INPUT STOPPED FOR PID pr
Approved For Release 2008/02/12 : CIA-RDP94T00858R000601000001-2
 u''-NJMBER
Approved For Release 2008/02/12 : CIA-RDP94T00858R000601000001-2 IU f ~.7E LEVEE rAGE
The error response is:
INH DT pt - INPUT ALREADY STOPPED
2.3.2.3.13. /IRL DT pt (Release Input Hold oo PID)
Resume input to the device with PID pt. The normal response is:
INPUT RESUMED FOR PID pt
The error response is:
IRL DT p, - INPUT WAS NOT HELD
NOTE.'
It all devices were marked to hold input, it is necessary to do a /RSP PE alb in order to resume input.
2.3.2.3.14. /ALT DT pt TO P2 (Alternate Address for PID)
All message traffic through the device with PID pt is rerouted to the device with PID P2. All traffic
queued for PID pt is queued to PID p2's main queue.
The normal response is:
PID pt TRAFFIC REROUTED TO PID P2 Ci
The error responses are:
PID pt - TRAFFIC ALREADY REROUTED
ALT DT pt TO P2 - REROUTING NOT POSSIBLE
ALT DT pt TO pt - NOT POSSIBLE
NOTE.-
This command can also be used with Telcon devices (SESSIONS). The P1D number for the Telcon
session can be obtained via the Status (S) command (see 2.3.3.3.5).
2.3.2.3.15. /RST DT pt (Resume Traffic on PID)
This reverses the action of the /ALT (Alternate Addressing) command. Traffic is no longer rerouted
from the named device to an alternate device. No requeuing of messages is done.
The normal response is:
PID p, WILL RECEIVE TRAFFIC
The error response is:
RST DT pt - NO REROUTING WAS IN EFFECT
Approved For Release 2008/02/12 : CIA-RDP94T00858R000601000001-2
 6745.1
UP-NUV9ER
I
Approved For Release 2008/02/12 : CIA-RDP94T00858R000601000001-2
LI~'iJ VpewdtufneleweliLe '_- UPDATEEEVEE PAGE
The response is:
n MSGS DELETED FOR PID pt (0