This manual describes the K-version of SINTRAN III and the H-version of ND-500 Monitor. The first part is an alphabetical list of the SINTRAN III commands and their precise details. The second part is an alphabetical list of commands in the SINTRAN-Service-Program. The third part is an alphabetical list of commands to the ND-500 Monitor. The final part consists of appendices. Changes from the previous version are indicated by a change bar.
This manual is a complete reference to the SINTRAN III monitor calls. It replaces chapter two in previous versions of the SINTRAN III Reference Manual.
This gives an introductory survey of the basic functions available for those with little or no knowledge of computers or those unfamiliar with the SINTRAN III operating system.
This describes the use of commands and monitor calls available for time sharing users. The commands and monitor calls are grouped according to function.
This describes the tasks performed by the System Supervisor who is responsible for keeping the system running properly from day to day. It contains descriptions of Accounting and the use of the SINTRAN-Service-Program.
I'm unable to process this image as it seems to be blank with only a page number and reference. If there is another page with content, please provide that for OCR conversion.
The command names are listed following the SINTRAN prompt character @. This character is written to the terminal by the system when SINTRAN is ready to accept a command. The user types characters after the @.
A command can be written as one or several lines, in upper or lower case. If the user types carriage return (CR) before all parameters are entered, SINTRAN asks for the missing parameters on the next lines.
A command may be written in one of the following ways (user input is underlined):
@LIST-FILES ALFA,TERMINAL
or
@LIST-FILES
FILE NAME: ALFA
OUTPUT FILE: TERMINAL
or
@LIST-FILES,ALFA
OUTPUT FILE: TERMINAL
or
@LIST-FILES
FILE NAME: ALFA,TERMINAL
or
@LIST-FILES,ALFA,,
The last example uses the default value for the parameter OUTPUT-FILE. To use a default value for the last parameter in a command requires an extra comma, one comma causes a request for the parameter.
The radix of a parameter may be specified by appending D (for decimal) or B (for octal) to the number.
Some parameters have default values, omitting parameters without default values causes an error message.
The notation [......] is used to indicate that the parts in brackets may be omitted.
The SINTRAN editing characters are used to edit the current or previous command line. The following editing functions may be used:
Command
Function
CTRL+A
Delete one character
CTRL+W
Delete one word backwards
CTRL+Q
Start a new empty line where old command can be edited (not XON/XOFF terminals)
CTRL+C
Copy one character
CTRL+D
Copy rest of line including RETURN
CTRL+F
Copy rest of line including RETURN (no echo)
CTRL+H
Copy rest of line, but NOT including RETURN
CTRL+Lx
Copy until and including "x"
CTRL+Ox
Copy until but NOT including "x"
CTRL+U
Copy until next TAB stop
CTRL+B
Skip one character
CTRL+S
Skip one character (not XON/XOFF terminals)
CTRL+Xx
Skip characters until and including "x"
CTRL+Px
Skip characters until but NOT including "x"
CTRL+E
Switch insert mode on/off
CTRL+I
Overwrite with spaces until next TAB stop
CTRL+Vx
Quote character "x" (also if CTRL character)
CTRL+T
Align new line with old line
CTRL+R
Type rest of lines and continue edit
CTRL+Y
Copy rest of line, no echo, and restart edit
CTRL+K
Erase line on display and restart edit
For example, pressing CTRL+A after @LIST-FO deletes the character O.
If the command @LIST-FI OLE,TERM has just been entered, pressing CTRL+Q reenters this command.
Beware that segment name may now be entered instead of segment number whenever a segment is to be specified. A segment name consists of 1-7 alphanumeric characters. The underline character (_), may be used as a separator in a segment name and will count as one character. Note that a segment name may not be abbreviated.
Stops an RT-program by setting it in the passive state. It is removed from the time queue and execution queue, all resources are released and periodic execution is discontinued.
Related commands:
Related SINTRAN III commands:
ABORT-BATCH
ABORT-JOB
STOP-TERMINAL
Related ND-500 Monitor commands:
ABORT-PROCESS
LOGOUT-PROCESS
Related SINTRAN III Monitor calls:
ABORT (MON 105)
RTEXT (MON 134)
Format:
@ABORT <program>
Parameters:
<program> RT-program name or RT-description address.
Rules:
Permitted only for users RT and SYSTEM
The command has effect only if the program is in the running or wait state.
Do not abort a background program. If a background program is hanging, the system may have to be restarted. Contact your system supervisor.
Name of peripheral file associated with spooling program.
<file name>
The file to be appended.
<no. of copies>
Number of output copies required (decimal value, default = 1).
<text>
Any printable characters terminated by an apostrophe '. The text is printed on the error device when file output is started. If no text is given ' alone must be given.
<printing message?>
YES = wait for a @START-PRINT command after printing <text>. This specification overrides @DEFINE-SPOOLING-CONDITIONS. NO = the text is printed on the error device only if @DEFINE-SPOOLING-CONDITIONS specifies print (default = NO).
One copy of the file F-1 is appended to the spooling queue of LINE-PRINTER. The message "MOUNT FORM-1" is output on the error device before the printing starts. The spooling program then waits for @START-PRINT.
The response is: BATCH NUMBER = n, where n is the decimal number of this batch processor. The number is used to identify this batch processor in other commands.
If no passive batch processor is available an error message is given.
When a batch processor is started, it enters the idle state because the batch queue is empty. It is activated by the first @APPEND-BATCH command.
If the optional parameter is used, the corresponding batch processor will start. Otherwise the first passive batch processor will be activated.
Rules:
1. Permitted only for user SYSTEM.
2. Should not be used in batch or mode jobs.
3. The subcommands must follow rule 3 given in @LOOK-AT. Terminate subcommands with a full stop.
4. The bit file is divided into 208 word blocks. <address> in subcommands is relative address within block (0 - 178).
<‘F’ or ‘R’> is only used for fixed or removable cartridge disk.
<subunit> is only required on logically sub-divided disks.
Note that if you give an erroneous disk type as device type (this may happen, for example, if your system has different disk types as different units and you specify the wrong unit), the disk will enter fault state and the system will hang.
The parameter <unit> is now always required.
The subcommands must follow the rules given for @LOOK-AT. Terminate subcommands with a full stop. <address> is relative address in the range 0 - 178.
Address within the directory (octal value, default = 0).
Rules:
Permitted only for user SYSTEM.
Should not be used in batch or mode jobs.
The subcommands must follow rule 3 given for @LOOK-AT. Terminate subcommands with a full stop. <address> is relative address within the page in the range 0 to 1777₈.
Example:
@CHANGE-PAGE PACK-TWO,100
400/ 1000 2000
2000 .
@
Change location 400 on page 100 in directory PACK-TWO from 1000 to 2000.
Rules:
1. Permitted for all users.
2. The password is only changed if the old one is specified correctly.
3. A password may consist of printable and control characters, except carriage return.
4. The parameters are not echoed on the terminal if the command is entered on more than one line (see example).
5. Only the password of the logged-in user may be changed.
Example:
@CHANGE-PASSWORD
OLD PASSWORD: [old password is entered]
NEW PASSWORD: [new password is entered]
@
Function:
Execute a clear device operation (IOX instruction). This command can for example be used to stop the line printer if an attempt is made to print non-alphanumeric information, or it can be used to stop a search for a nonexistent EOF mark on a magnetic tape and prevent the tape from winding off.
Related commands:
Related SINTRAN III commands: DEVICE-FUNCTION CLEAR-DEVICE
EXECUTE-IOX
IOSET
Format:
@CLEAR-DEVICE
Parameters: <logical device no.> logical number of a peripheral device (octal value).
Rules:
1. Permitted only for user SYSTEM.
2. @CLEAR-DEVICE on a magnetic tape operates on the magnetic tape controller, that is, if several magnetic tape stations are connected to the same controller, they are all cleared through one @CLEAR-DEVICE command.
Function:
To clear a specified segment, that is, release the space on the segment file occupied by that segment. The segment number will then be free again.
Related commands:
Related SINTRAN III commands: LOAD-REENTRANT-SEGMENT
Related RT-Loader commands: CLEAR-SEGMENT
Parameters:
\<terminal number> the terminal indicated will be treated as console terminal during the start-up process.
Rules:
Permitted only for user SYSTEM.
The contents of the save-areas is transferred to the image-area on SEGFILE0 and to the other "run"-segments, and the system is started. The contents of user segments and reentrant segments must be built up again by running the mode file HENT-MODE, and using the DUMP-REENTRANT and/or DUMP-PROGRAM-REENTRANT commands.
If the system includes separate processors (ND-500 part, HDLC, etc.) these should be stopped before COLD-START.
Cannot be used to restart:
a. DMAC
b. SINTRAN-Service-Program
c. MAIL
d. RT-Loader
e. A program started with @PLACE-BINARY and @GOTO-USER or @LOAD-BINARY.
f. A program running on the ND-500.
Function:
Copy data to a destination file from a source file. The file is copied byte by byte.
Related commands:
Related SINTRAN III commands: COPY-FILE
Format:
@COPY ,
Parameters:
Parameter
Description
a file to which data is copied. It may be any type of file (default type = :SYMB).
a file from which data is copied (default type = :SYMB).
Rules:
1. Permitted for all users.
2. If the is a mass-storage file with a hole, the copying will stop at the hole and the error message NO SUCH PAGE will be given.
3. The file is copied byte for byte up to the value of the maximum byte pointer.
4. Both and may specify files on a remote computer. The file specifications may contain the following parameters:
Valid only for devices which can contain directories.
A directory must exist on the source device.
Destination device must not be an entered directory.
Note that if you give an erroneous disk type as device type (this may happen, for example, if your system has different disk types as different units and you specify the wrong unit), the disk will enter fault state and the system will hang.
Function:
Copy data to a destination file from a source file. The file is copied page by page if both files are mass-storage files.
Related commands:
Related SINTRAN III commands: COPY
Format:
@COPY-FILE ,
Parameters:
| Parameter | Description |
|--------------------|------------------------------------------------------------------------|
| | a file to which data is copied (default type = :SYMB). |
| | a file from which data is copied (default type = :SYMB). |
Rules:
Permitted for all users.
If the is a peripheral file and the mass-storage is an indexed file with a hole, copying stops at the hole and the error message NO SUCH PAGE is given.
If both files are mass-storage files, the file is copied including holes.
All pages allocated to the are copied, except if there are zero bytes in the file.
If the does not exist, it is created by giving the name in quotes. It will be an indexed file.
Both and may specify files on a remote computer. The file specifications may contain the following parameters:
Function:
Create a new directory on a disk (or part of a disk). Any old directory which may have been on the disk is destroyed, and the files on it are lost. The directory name, as part of the directory entry, is written to the disk. The bit file area is allocated by the file system in the middle of the directory (unless the user specifies a page address) starting from the beginning of a track. The bit file pages are tested by performing write and compare with three standard test patterns before being cleared. If there is a bad page in the bit file area the file system automatically locates the bit file on an adjacent track.
Using default position for the bit file restricts the maximum length of a contiguous file to half the size of the disk, but the user can specify another location for the bit file to get more contiguous space. In the case of ECC disks the disk driver tests the disk to see if it has been formatted with spare-track re-allocation (and sets the TYPE C bit in the big disk data field). If yes, the testing of all pages on the disk is skipped. If the disk has not been formatted with spare-track re-allocation, or on other disk types, every page is tested by performing a read and compare from the disk. Any page in error is marked as used in the bit map.
Related Commands:
Related SINTRAN III commands: ENTER-DIRECTORY, RENAME-DIRECTORY
Format:
@CREATE-DIRECTORY <directory name>,<device name>,<unit>[,<‘F’ or ‘R’>][,<subunit>],<bit file address>
Parameters:
Parameter
Description
<directory name>
the name to be written onto the new directory. A maximum of 16 alphanumeric characters, including the hyphen -, is legal.
<device name>
device name, see appendix F for a list of legal device names.
<unit>
device unit number (0-3, default 0).
<‘F’ or ‘R’>
F (for fixed) or R (for removable) part of a disk. This parameter only apply to disks which have both a fixed and a removable part.
<subunit>
subunit number. This parameter only apply to disks which are subdivided into several parts or directories (0-5).
<bit file address>
specified if the user wants to place the bit file in a particular area. (octal value, default = the file system will select a medium dependent optimal value.) The System Supervisor manual contains more information on this parameter.
Permitted only for user SYSTEM when hard disk is specified, for all users when floppy disk.
Fixed or removable is specified only for 10, 30, 60, 90Mb cartridge disks.
Note that if you give an erroneous disk type as device type (this may happen, for example, if your system has different disk types as different units and you specify the wrong unit), the disk will enter fault state and the system will hang.
Function:
Create one or more versions of a file. The file will be contiguous or indexed depending on <no. of pages>.
Related commands:
Related SINTRAN III commands: ALLOCATE-FILE
CREATE-NEW-VERSION
OPEN-FILE
RENAME-FILE
Format: @CREATE-FILE <file name>,<no. of pages>
Parameters:
Parameter
Description
<file name>
Optional version number specifies number of versions to be created (default type = .DATA). File type should be specified, if not: .DATA (default) is assumed.
<no. of pages>
0: create empty file, the file will be indexed the first time something is written to it, or be contiguous if expanded with @EXPAND-FILE. > 0: create contiguous file with the specified no. of pages (decimal value, default = 0).
Rules:
Permitted for all users.
If there are not enough pages for all versions, the system creates as many as possible and gives an error message. To find the number created, use @LIST-FILES.
Contiguous files are positioned in the highest page address range possible on the directory.
Contiguous files are more efficient than indexed files. If contiguous files can be used, performance may be improved.
Example: @CREATE-FILE F-1,0
One version of the indexed file F-1:DATA is created in default directory.
A user can have a maximum of eight friends, and all must belong to the same main directory as him/her.
When the friend is created, his/her general default file access to the terminal user's files is read, write and append (RWA). This can be changed by @SET-FRIEND-ACCESS. Friends can be given restricted access to a specific file by @SET-FILE-ACCESS.
Access given to a friend overrides public access, even if it is more limited than public access.
Function:
Create one or more new versions of an existing file.
Related commands:
Related SINTRAN III commands: ALLOCATE-NEW-VERSION
CREATE-FILE
Format: @CREATE-NEW-VERSION <file name>,<no. of pages>
Parameters: <file name> for version (v) see rule 3 below (default type = :DATA). <no. of pages> see @CREATE-FILE.
Rules:
Permitted for all users with directory access (D) to the user's file space.
See @CREATE-FILE, rule 2.
If version v already exists, one new version is created and inserted as this version. The old version is renumbered as v + 1 and so on. If v is higher than the highest version existing (= w) the versions w + 1, w + 2, ....., v are created. Default version is w + 1.
A new version can be created by other commands (for example @OPEN-FILE). The file version number is then enclosed in quotes.
Example: @CREATE-NEW-VERSION F-1;4,0
Versions 2, 3 and 4 of the indexed file F-1 are created.
This command is used to define a (global) command string, normally a recover command, to enter a user program immediately after LOGIN, that is, before @ and after OK. Although the command string is global it can be enabled and disabled for each terminal individually.
Related commands:
Related SINTRAN III commands:
DEFAULT-SUBSYSTEM-DISABLE
DEFAULT-SUBSYSTEM-ENABLE
LIST-DEFAULT-SUBSYSTEM
Format:
@DEFINE-DEFAULT-SUBSYSTEM
Parameters:
Parameter
Description
Command string or subsystem name to be executed at LOGIN.
Rules:
1. Permitted for user SYSTEM only.
2. Unlike CHANGE-LOCAL-CHARACTER the effect of this command survives after LOGOUT.
3. The defined local character will not survive a warm start.
4. If you want the defined local character to be set permanently, use SINTRAN-SERVICE-PROGRAM subcommand CHANGE-DATAFIELD, as the local character is stored in the 8 most significant bits in displacement CESC. The 8 least significant bits hold the octal value of the escape character.
Define a mass-storage device in the directory table. This is used to reserve a directory index for a device even if the device is not to be entered yet. On standard versions of SINTRAN III/VSX version K, devices are not allocated a directory index at generation time, but are placed in the directory table when the device is defined. Defining a device is done either by entering it (@ENTER-DIRECTORY), or by this command.
Define termination handling for background or RT-programs in case of termination with escape, MON 65 or fatal errors such as executing privileged instructions etc.
Related commands:
Related SINTRAN III commands:
Related SINTRAN III Monitor calls:
ENABLE-TERMINATION-HANDLING
EDTRM (MON 206)
LIST-TERMINATION-HANDLING
NEXT-TERMINATION-COMMAND
Format:
@DEFINE-TERMINATION-HANDLING
Parameters:
Parameter
Description
Define termination handling for RT-programs or background programs.
Name of the RT-program to be started or the commands to be executed.
Rules:
In background a (global) set of commands is executed when interactive or mode (not batch) jobs are terminated abnormally.
In background the command is used like @INITIAL-COMMAND. The command buffer pointer is reset and the first command can be defined. If more than one command is to be defined, use @NEXT-TERMINATION-COMMAND.
In RT-termination the name of a user-defined RT-program should be given as a parameter. If enabled, this program will be started whenever a user RT-program terminates.
@MODE cannot be defined as a termination command and if a program is started (by a recover command) this will be the last command executed and termination will not be re-enabled automatically.
Parameters:
| Parameter | Description |
|--------------|---------------------------------------------------------------|
| <batch no.>| batch processor number as returned from @BATCH. |
| <input file>| the file to be deleted. |
| <output file>| associated output file in batch queue. |
Rules:
1. Permitted only for user SYSTEM and the owner of the <input file>.
2. Valid only if second and third parameters match with a queue entry. These must be spelled exactly the same way as in @APPEND-BATCH.
3. The currently active batch job must be deleted by @ABORT-JOB.
4. If more than one entry matches, only the first one is deleted.
5. @LIST-BATCH-QUEUE may be used to find the correct spelling of the second and third parameters.
The batch job file JOB-1 is deleted from the queue to batch processor 1 (if matched). LINE-PRINTER was the output device in the corresponding @APPEND-BATCH command.
An unambiguous file name. The type must be specified (no default type). If a version is specified only that version is deleted (default = all versions).
Rules:
Permitted for all users with directory (D) access to the file.
If version v is deleted, the version numbers of v + 1, v + 2, ... are decreased by 1.
Function:
Delete a reentrant subsystem. The segment where the reentrant subsystem resides is cleared, as well as the corresponding entry in the reentrant subsystem table.
Related commands:
Related SINTRAN III commands: DUMP-PROGRAM-REENTRANT
DUMP-REENTRANT
Format:
@DELETE-REENTRANT <name>
Parameters: <name>
name of the subsystem to be deleted.
Function:
Remove a remote batch input file from the remote batch queue to a remote computer. (The file is removed before it is sent to the remote computer.)
Related commands:
Related SINTRAN III commands: APPEND-REMOTE
Format:
@DELETE-REMOTE-QUEUE-ENTRY ,
Parameters: see @APPEND-REMOTE. a file name previously given in the @APPEND-REMOTE command (parameter must match exactly the remote batch queue entry and the user name must be given).
Rules:
1. Permitted only for user SYSTEM and the owner of the file.
2. If the queue contains two or more equivalent entries, only the first one will be removed.
Function:
A file is removed from the spooling queue of a spooling device. If it is a spooling file, its pages are released and returned to the pool of free spooling pages and the file is marked as unused.
Related commands:
Related SINTRAN III commands: REMOVE-FROM-SPOOLING-QUEUE
Rules:
1. Permitted only for user SYSTEM and the user who appended the file, or if the file was appended by an RT-program, only users SYSTEM and RT.
2. Only the first name matching <file name> is removed.
3. If the file is not a spooling file, the command is equivalent to @REMOVE-FROM-SPOOLING-QUEUE.
4. The parameter <file name> may specify files on a remote computer. The file specification may contain the following parameters:
If the file LINE-PRINTER::10 is in the spooling queue to LINE-PRINTER, it is deleted from the queue; if it is a spooling file, its pages are removed and it exists as an object in the file system with no pages.
Related commands:
Related SINTRAN III commands: CREATE-USER
GIVE-USER-SPACE
LIST-USERS
TAKE-USER-SPACE
Format:
@DELETE-USER [:]
Parameters:
| Parameter | Description |
|-------------------------|-----------------------------------------------------------------------------|
| : | user to be removed on the particular directory (default directory = the user's main directory). |
Rules:
1. Permitted only for user SYSTEM when hard disk is specified, for all users when floppy disk.
2. Valid only if the user has no files.
Example:
@DELETE-USER USER-ONE
The user USER-ONE is deleted from their main directory.
Parameters: <file name>: delete all files matching this name (default = delete all files in default directory for the terminal user). <manual check?>: YES = the name of every file matching <file name> is written on the terminal. The user then answers YES to delete, NO or return to keep the file. NO = delete all files matching <file name> immediately. (default = YES).
Rules:
1. Permitted for all users with directory access (D) to the files.
2. If current user is SYSTEM, manual check is compulsory so the parameter <manual check?> is not requested.
Example: @DELETE-USER-FILES F-1, YES FILE 5: (BIG-PACK:GUEST) F-10:DATA;1? N FILE 7: (BIG-PACK:GUEST) F-1:DATA;1? Y @
The file F-1:DATA is deleted but match was also found on the file F-10:DATA, which was not deleted.
Function:
Advance from the current position on a device over the specified number of end-of-file (EOF) marks. A tape will be positioned immediately after the last EOF mark is passed. A floppy disk will have its address incremented to the address immediately after the last EOF mark is passed.
Related commands:
Related SINTRAN III commands:
- DEVICE-FUNCTION ADVANCE-RECORDS
- DEVICE-FUNCTION BACKSPACE-RECORDS
- DEVICE-FUNCTION REVERSE-TO-EOF
- DEVICE-FUNCTION REWIND
Format:
ADVANCE-TO-EOF \<number of EOF marks>
Parameters:
\<number of EOF marks> the number of EOF marks to skip.
Rules:
1. Allowed on magnetic tape and floppy disk.
On magnetic tape, move the tape backwards by the specified number of records; on floppy disk, decrement the disk address by the specified number of records.
Dump a bootstrap onto page 0 (the first page) of a floppy. The floppy monitor can then be loaded into a machine (not running SINTRAN) by pressing MASTER CLEAR and typing 15608.
Format:
DUMP-BOOTSTRAP
Parameters:
| | name of the :BPUN file containing the bootstrap. This will normally be FLOPPY-MONITOR:BPUN or a carefully prepared user monitor. |
Related SINTRAN III commands: DEVICE-FUNCTION FORMAT-FLOPPY
DEVICE-FUNCTION READ-FORMAT
Format:
SET-FLOPPY-FORMAT
Parameters:
Format number as defined in the following table:
No.
Bytes/Sector
Number of sides
Density
Sectors/diskette
Capacity in pages
0
512
Single
Single
11508
154
1
256
Single
Single
22038
144
2
128
Single
Single
37228
125
4
512
Double
Single
23208
308
5
256
Double
Single
44068
288
6
128
Double
Single
76448
250
10₈
512
Single
Double
22038
288
11₈
256
Single
Double
37228
250
13₈
1024
Single
Double
11508
308
14₈
512
Double
Double
44068
577
15₈
256
Double
Double
76448
500
17₈
1024
Double
Double
23208
616
The SINTRAN III file system can only be used with formats 0 and 17₈. All of the listed formats are available on the new floppy disk system (controller 3027). Only formats 0, 1 and 2 are available on the old floppy disk system.
Rules:
Allowed on floppy disk.
The function, SET-FLOPPY-FORMAT, should always be the first function used before formatting diskettes.
Function:
List the following for one or more entered directories:
1. Device name and unit number.
2. Directory status (default, main).
3. Unreserved, unused and total space on the device.
4. Size of the largest unreserved contiguous block on the directory
Related commands:
Related SINTRAN III commands: LIST-DIRECTORIES-ENTERED
the directory/directories to be listed (default = all directories entered).
<output file>
destination of listing (default = TERMINAL).
Rules:
1. Permitted for all users.
2. The command requires some time to respond when referring to large disks.
Example: @DIRECTORY-STATISTICS,,
DIR INDEX 0: DISC-75MB-1 UNIT 0 : JOHNNY-ALVARADO
(MAIN AND DEFAULT DIRECTORY)
9298 PAGES UNRESERVED AND 6782 PAGES UNUSED OUT OF 36945 PAGES
MAXIMUM UNRESERVED CONTIGUOUS AREA ON DIRECTORY 2663 PAGES
DIR INDEX 1 : DISC-75MB-1 UNIT 1 : FILESYSTEM-TEST
(MAIN AND DEFAULT DIRECTORY)
(RESERVED FOR SPECIAL USE)
DIR INDEX 4 : FLOPPY-DISC-1 UNIT 0 : FLOPPY DIRECTORY
9 PAGES UNRESERVED AND 52 PAGES UNUSED OUT OF 154 PAGES
MAXIMUM UNRESERVED CONTIGUOUS AREA ON DIRECTORY 44 PAGES
Statistics for all the entered directories are listed on the terminal.
Function:
All connections to an RT-program made by @CONCT (or monitor call CONCT) are removed. If the program is in the time queue, it is removed. Periodic execution is prevented.
Related commands:
Related SINTRAN III commands: CONCT
Related SINTRAN III Monitor calls:
CONCT (MON 106)
DMAC (MON 51)
DSCNT (MON 107)
Format:
@DSCNT
Parameters:
Parameter
Description
<program name>
RT-program name or RT-description address (octal value, default = own terminal background program).
Note that if you give an erroneous disk type as device type (this may happen, for example, if your system has different disk types as different units and you specify the wrong unit), the disk will enter fault state and the system will hang.
Establish a subsystem as a reentrant subsystem. The subsystem is read from a :PROG file. The command then calls the RT-Loader and the subsystem is loaded to a segment. The subsystem name is inserted into a table which is searched by @RECOVER before the list of :PROG files is searched. The segment may be given a name by an optional parameter.
Establish a subsystem as a reentrant subsystem. The subsystem is read from a file of type :BPUN. The command then calls the RT-Loader and the subsystem is loaded to a segment. The subsystem name is inserted into a table which is searched by @RECOVER before the list of :PROG files is searched.
Name of a user on a main directory; if the user's main directory is known, user name can be given as <directory name>:<user name>.
<password>
The correct password for the user; it is not printed on the output listing (default = no password).
<project password>
A background accounting project defined in the file PROJNAM:DATA. See SINTRAN III System Supervisor manual, ND-30.003.
<maximum time>
The maximum CPU time, in minutes, allowed for the total batch job. When time is up the job is aborted (decimal value, default = 1).
Rules:
1. Permitted for all users.
2. If <password> is incorrect, the job is aborted.
3. If the job is run under @MODE, the @ENTER command is ignored.
4. A batch job is terminated by two escape characters. (Entered into the file, in PED, by typing [CTRL+O escape] twice.)
5. A batch input file may contain several batch jobs.
Example: @ENTER GUEST,,,5
This is the first command in a batch job. The job is run for user GUEST who has no password and no project password. The job will terminate after 5 minutes CPU time.
Enter a directory on a device. This must be done before files can be accessed on the directory.
Related commands:
Related SINTRAN III commands:
CREATE-DIRECTORY
RELEASE-DIRECTORY
SET-DEFAULT-DIRECTORY
SET-MAIN-DIRECTORY
Format:
@ENTER-DIRECTORY <directory name>,<device name>,<unit>[,<‘F’ or ‘R’>][,<subunit>]
Parameters:
Parameter
Description
<directory name>
the name of the new directory. default = directory on specified device/unit.
<device name>
device name, see appendix F for a list of legal device names.
<unit>
device unit number (0-3, default 0).
<‘F’ or ‘R’>
F (for fixed) or R (for removable) part of a disk. This parameter only apply to disks which have both a fixed and a removable part.
<subunit>
subunit number. This parameter only apply to disks which are subdivided into several parts or directories (0-5).
Rules:
For floppy directories: Permitted for all users. For all other directories: Permitted only for user SYSTEM.
The directory is only entered if <directory name> matches or is an abbreviation of the name found on the device.
All open files are closed. Open spooling files are emptied.
User enter counts are set to 0.
If <directory name> is omitted, the directory residing on the specified device/unit will be entered as long as no other directory with the same name already is entered.
Note that if you give an erroneous disk type as device type (this may happen, for example, if your system has different disk types as different units and you specify the wrong unit), the disk will enter fault state and the system will hang.
The parameter <unit> is now always required.
Example:
@ENTER-DIRECTORY PACK-ONE,DISC-10MB-1,1,F
A directory named PACK-ONE is entered on device DISC-10MB-1, unit 1, fixed pack.
Function:
Increase the length of a contiguous file.
Related commands:
Related SINTRAN III commands: ALLOCATE-FILE
CREATE-FILE
Format:
@EXPAND-FILE ,
Parameters:
| Parameter | Description |
|----------------|-------------------------------------------------------|
| <file name> | the contiguous file to be expanded. |
| <no. of pages> | the additional number of pages (decimal value). |
Rules:
1. Permitted for all users.
2. File must be contiguous.
3. The command only works if there are at least the requested number of free pages immediately following the specified file.
4. If the command fails because free space is not available, create a new file large enough to meet the requirements, then copy the contents of the old file to this new file and delete the old one.
Function:
List the following for the file(s):
1. File object number
2. File name
3. Type (indexed, contiguous, temporary, peripheral, spooling or allocated file)
4. Access modes
5. Date of creation
6. Number of times opened
7. Last time opened for read and write
8. Size of file (in pages and bytes)
9. Device number if peripheral file.
Related commands:
Related SINTRAN III commands: LIST-FILES
LIST-OPEN-FILES
Format:
@FILE-STATISTICS ,
Parameters:
| Parameter | Description |
|----------------|----------------------------------------------------------------------------------------------------------------------|
| <file name> | list all files matching this name. Can be abbreviated (default = all files in default directory for the current user). |
| <output file>| destination of the list (default = terminal). |
Rules:
1. Permitted for all users who have read access to the file.
2. <file name> may specify files on a remote computer. The file specifications may contain the following parameters:
Function:
Find the symbolic name of an RT-program from the address of its RT-description.
Related commands:
Related SINTRAN III commands: LIST-RT-DESCRIPTION LIST-RT-PROGRAMS
Related SINTRAN III Monitor calls: GRTNA (MON 152)
Format: @GET-RT-NAME <address>
Parameters: <address> RT-description address (octal value, default = background program of the user's terminal).
Rules:
1. Permitted only for users RT and SYSTEM.
2. Some system programs in SINTRAN have no symbolic name. They can be given names by the RT-Loader command DEFINE-PROGRAM.
This command will make it possible to create more than 256 files for a single user. To allow this, the user must be given more than the single object block given initially. Each object block contains object entries for 256 files. The maximum number of object blocks per user is 16 (which means a maximum of 4096 files). The number of files allowed for a user is reported by the command @USER-STATISTICS.
Function:
Increase the total number of pages that can be used by the spooling files.
Related commands:
Related SINTRAN III commands: SPOOLING-PAGES-LEFT
TAKE-SPOOLING-PAGES
Format:
@GIVE-SPOOLING-PAGES \<no. of pages>
Parameters:
\<no. of pages> additional no. of pages (decimal value).
Rules:
Permitted only for user SYSTEM.
500 pages are given to the spooling system.
The command does not guarantee that the disk space is available (see @START-SPOOLING, rule 2). User system must have at least as many free pages as there are pages for spooling.
When a program is terminated by an "escape" or "break", all files are normally closed. To keep them open until @GOTO-USER is typed, @SET-PERMANENT-OPEN is used before the files are accessed for the first time.
After "escape" the values of the background RT-program registers may be examined by @STATUS.
@OPEN F-1:DATA, RX
FILE NUMBER IS: 101
@SET-PERMANENT-OPEN 101
@RECOVER MAIN
('escape')
@GOTO-USER,,
The program MAIN is started, stopped and finally resumed at the point of interruption. The file F-1:DATA is kept permanently opened so it is not closed at the "break" (files not permanently open will be closed when you type escape).
Note the difference between CONTINUE and GOTO-USER: CONTINUE will restart the program at its start address, GOTO-USER at the specified address (or current value of the P-register).
Function:
Initialize the accounting files and start accounting.
Related commands:
Related SINTRAN III commands: START-ACCOUNTING
STOP-ACCOUNTING
Format: @INIT-ACCOUNTING <no. of accounts>,<max.no.>,<background>,[<RT>,<clear logged information>,<logging interval>,]<spooling>
Parameters:
Parameter
Description
<no. of accounts>
number of accounts before warning (decimal value, default = 1000).
<max.no.>
maximum number of accounts (decimal value, default = 1200).
<background>
are background programs to be accounted, both on ND-100 and ND-500.
<RT>
are user RT-programs to be accounted.
<clear logged information>
whether information already logged in the RT accounting table should be cleared.
<logging interval>
number of seconds between dumps of RT accounting table on file ACCOUNTS:DATA.
<spooling>
are spooling processes to be accounted.
Rules:
Permitted only for user SYSTEM.
When <desired> number of records is reached, the message "APPROACHING END OF ACCOUNTING FILE" is written on the terminal at every log out.
When <maximum> number of records is reached, the message "FND OF ACCOUNTING FILE ENCOUNTERED" is written on the terminal at every log out. No further accounting is attempted until the next @INIT-ACCOUNTING or until ACCOUNTS:DATA is reset by the ACCOUNTING-SERVICE-PROGRAM.
If RT-accounting is not included in the system, the question <RT> will not be asked. If the message "ACCRT NOT LOADED" is given after answering Y to <RT> the ACCRT-program must be loaded onto segment 32 with the RT-Loader (see System Supervisor manual, ND-30.003).
Only if the system contains an ND-500 will the question <ND-500> be asked.
Accounting on an ND-500 or spooling cannot be started unless background accounting is running. It can be stopped independently but is stopped automatically if background accounting is stopped.
The accounting system is initialized. A warning is given after 750 records and after 850 records no further logging takes place until the file is reset. Background and user RT-programs are accounted, information already in the RT-accounting table is cleared and dumps take place every 600 sec.
Specify the first command to be executed at next restart from memory image, @RESTART-SYSTEM, or pressing MASTER CLEAR and LOAD buttons. The command must be @ENTER-DIRECTORY. It is stored as the first command in the initial command buffer.
When @INITIAL-COMMAND has been issued, @RTENTER is automatically executed at subsequent restarts.
The other commands in the initial command buffer are specified using @NEXT-INITIAL-COMMAND.
If user RT has file space on a directory other than the first main directory to be entered, this directory must be entered and set as a default directory in the initial commands. Failure to do this means @RTOPEN or OPEN from an RT-program will not access user RT's files by default.
Function:
Initiate the background programs for terminals and batch processors.
Related commands:
Related SINTRAN III commands: SET-AVAILABLE
Format:
@INITIALIZE-BACKGROUND-PROGRAMS
Parameters:
None.
Rules:
Permitted only for user SYSTEM.
After a cold start (HENT in MACM or @COLD-START) or initial load, the segment file(s) are defined (see @SINTRAN-SERVICE-PROGRAM *DEFINE-SEGMENT-FILE) and then this command is used to initialize background programs (that is, allocate space for them on the segment file) before any reentrant subsystems are dumped.
If necessary, @CHANGE-BACKGROUND-SEGMENT-SIZE must be used after @INITIALIZE-BACKGROUND-PROGRAMS.
The program must be activated by @CONCT, @RT or MON 100. It is then put in the time queue. At the end of the interval it is transferred from the time queue to the execution queue and at the same time put back in the time queue. This is repeated periodically.
-1 = reset device. For card reader: -1 = clear buffer and set ASCII mode. All characters are converted to ASCII and trailing blanks are ignored. 0 = set ASCII mode. 1 = set binary mode. Subsequent INBT monitor calls will return a 12-bit column image. For synchronous modem output: -1 = clear modem output buffer 0 = start sending of the current block 1 = set 377 bytes to send between data 2 = set ASCII synchronous to send 3 = set EBCDIC synchronous to send 4 = synchronise on 26 received (ASCII) 5 = synchronise on 62 received (EBCDIC) 6 = synchronise on 226 received (ASCII) 7 = set ASCII synchronous (226 to send between data)
Function:
List the contents of a specific batch queue.
Related commands:
Related SINTRAN III commands: LIST-BATCH-PROCESS
Format:
@LIST-BATCH-QUEUE
Parameters:
| Parameter | Description |
|-------------|-----------------------------------------------------------------------|
| | batch processor number as returned from @BATCH or @LIST-BATCH-PROCESS.|
Rules:
1. Permitted for all users.
2. The command has no effect on the batch processor.
Function:
List all the programs in the execution queue. The list contains the name or address of the RT-description.
Related commands:
Related SINTRAN III commands: LIST-TIME-QUEUE
Format:
@LIST-EXECUTION-QUEUE
Parameters:
None.
Rules:
1. Permitted for all users.
2. Programs are listed in the order in which they occur in the queue, that is, in order of decreasing priority.
3. When the list of RT-programs in the execution queue is greater than 16, the list is sorted columnwise from left to right.