3-76
Syntax
L
!iET --=r<file title>lOAD
I r~--/I\-<sequence
rangel~ I
~/1\-
AS --<filename>~
~.~---~~---~
1
~ /1\- USECATAlOG [, J [ IRUE
= fALSE /1 \- VERSIO~ [
J
<number>/1 \- CYCLE =
/1\- GENERATION
/1\- MARKID --<dlm>--<ID>--<dlm>
Explanation
The GET command designates an existing saved file, or portions thereof, as the source for a new work file. LOAD is a synonym for GET. If an unsaved work file exists, the command is ignored and the following message is displayed:
#REMOVE OR SAVE WORKFILE
The work file must be removed or saved. To specify a new work file, reenter the GET or LOAD command.
The < file title> construct can specify any file to which the user is permitted access. If desired, a < sequence range list> can be specified, causing only a portion or portions of the file to be used as the source.
The name of the work file to be created can be specified by using the AS < file name>
option; otherwise, the work file name is a temporary copy of the file title.
The GET command might be unable to retrieve a file as a work file if the file name is not in the user's directory and the AS < file name> option is absent. A file is not in the user's directory when the file name is preceded with an asterisk (*) ·or another's usercode, or an ON clause specifies a family name for the file. When you use the GET command to retrieve a file that is not in your directory, that file is considered a foreign file. That is, the retrieved file is not a work file. The following message is an example of what is displayed when a file is retrieved as a foreign file:
#WORKFILE IS NOT NAMED; SOURCE IS *LEDGER/JANUARY ON GL: SEQ, 27221 RECORDS
When the LOCKED FILE attribute is set to TRUE for a file, that file is retrieved as a foreign file because that file cannot be removed and its file name cannot be changed.
For more information about the LOCKEDFILE file attribute, refer to the File Attributes Reference Manual. See the ALTER command earlier in this section for information about changing the LOCKEDFILE attribute.
8600 1500-010
GET Command (cent.)
For installations that use file cataloging, the GET command allows specification of USECATALOG, VERSION, CYCLE, and GENERATION. For an explanation of these attributes, refer to the File Attributes Reference Manual.
The MARKID < dlm > < ID > < dlm > option establishes an initial MARKID. The MARKID command can still be used at any time afterwards to establish a new MARKID.
The following commands display the correspondence between the ID field of a record and the current value of the MARKID, if the MARKID option is specified:
• FIND on a work file using the TEXT option
• RANGE on a work file using the TEXT option
• LIST on a work file without the UNSEQUENCED or PUNCH options
• REPLACE using the TEXT option, before the record ID field is replaced The displays from each of the preceding commands include the following:
• The sequence number
• An asterisk (*) if the record ID is the same as the MARKID; otherwise, a blank
• The text Examples GET AFILE
#WORKFILE AFILE: SEQ, 5 RECORDS, SAVED LOAD TERMPAPER 400-END AS INDEX
#WORKFILE INDEX; SOURCE IS (UZER)TERMPAPER ON USERPACK: DATA GET (ANYUSER)ANYFILE ON HISPACK AS MYWORKFILE 0-150,400-END
#WORKFILE MYWORKFILE; SOURCE IS (ANYUSER)ANYFILE ON HISPACK: ALGOL GET EXAMPLE: MARKID_10/01/81_
#WORKFILE EXAMPLE: ALGOL,500 RECORDS, SAVED, MARKID "10/01/81 "
I
GET Command (cont.)
3-78
The following examples show the results of attempts to retrieve files where the LOCKEDFILE file attribute has either been set or reset.
• The following example retrieves the file LEDGER/JUNE that is in the user's directory and the LOCKEDFILE file attribute is reset to FALSE.
GET LEDGER/JUNE
#WORKFILE LEDGER/JUNE: SEQ, 23000 RECORDS, SAVED
• The following example retrieves the file LEDGER/JUNE that is in the user's directory (ACCT) as a workfile named LEDGER/2NDQTR. The LOCKEDFILE file attribute is reset to FALSE.
GET LEDGER/JUNE AS LEDGER/2NDQTR
#WORKFILE LEDGER/2NDQTR;SOURCE IS (ACCT)LEDGER/JUNE ON PACK: SEQ, 23000 RECORDS
• The following example shows an attempt to retrieve the file LEDGER/JUNE that is in the user's directory (ACCT) as a workfile. The LOCKEDFILE file attribute is set to TRUE.
•
GET LEDGER/JUNE
#WORKFILE IS NOT NAMED; SOURCE IS (ACCT)LEDGER/JUNE ON PACK(LOCKEDFILE):
SEQ, 23000 RECORDS
The following example retrieves the file LEDGER/JUNE that is in the user's directory (ACCT) as a workfile named LEDGER/COPY. The LOCKEDFILE file attribute is set to TRUE.
GET LEDGER/JUNE AS LEDGER/COPY
#WORKFILE LEDGER/COPY; SOURCE IS (ACCT)LEDGER/JUNE ON PACK(LOCKEDFILE):
SEQ, 23000 RECORDS
8600 1500-010
HELLO Command
HELLO
Syntax
-- HELLO ~---~---~%
L<usercode> ~
t ; ]
<password;:::j ExplanationThe HELLO command terminates the current session and initiates a new session after log on is complete. Dial-up lines are not disconnected.
When HELLO is entered, the current session ends and CANDE displays system resource usage statistics, followed by the usual greeting, which contains
• System name and serial nmnber
• CANDE MCS name (usually CANDE) and version level
• System hostname
• Station name and LSN
System resource usage statistics are provided in the form of the session number, elapsed time of session (ET), processor time consumed (PT), I/O time consmned (10), usercode, current time, and the date. They are printed in the following format:
#END SESSION <session number> ET=<time> PT=<time> IO=<time>
HUSER
=
<usercode> <time> <date>A chargecode and accesscode are also printed if applicable. A prompt is then issued to enter a usercode.
When HELLO < usercode > <password> is entered, the log-on procedure is completed (an accesscode and chargecode might also be requested to log on). If the < password> is not entered, the system requests this information in the normal log-on manner.
On InfoGuard systems with the SECOPT CLASS set to S1 or higher, the password must be entered on a separate line. Refer to the Security Administration Guide for additional information about security options.
If an unsaved work file exists when the HELLO command is entered, CANDE displays the following message:
#REMOVE OR SAVE WORKFILE
The user must save or remove the work file and re-enter the HELLO command before CANDE will terminate the session.
The < usercode > . form is used to log on to a usercode that does not have a password.
HELLO Command (cant.)
3-788 8600 1500-010
HELLO Command (cent.)
For additional information about usercode/passwords and logging on, refer to "User Identification and Logging On" in Section 1, "General Information."
Examples HELLO UZER/PSW
#END SESSION 0383 ET=2:13:35.7 PT=21.7 10=43.4
#USER
=
PAYROLL CHARGE=
4736. 10:05:12 10/20/84#87900:7 CANOE 36.120 AT SITE7; YOU ARE T012345(83)
#SESSION
=
0824 USER=
PAYROLL CHARGE=
4736 hello userid#ENTER PASSWORD PLEASE HELLO USERIO PASSID
#SESSION 3975 16:30:56 04/20/78
INSERT Command
INSERT
3-80
Syntax
~
-- INSERT 1 / 1 * \ <file title
<sequence range list
I---r-<sequence range 1 i st
<file title /1*\- AT 1<base
NEXT + --<i nc>---I END
Explanation
The INSERT command copies lines from a file (by default, the work file) and places the copies in the work file as a contiguous block with new sequence numbers.
An UPDATE is implicitly invoked after the INSERT has been executed.
The < file title> construct names the file to be inserted and can be any file to which the user is allowed access. The work file is assumed if no < file title> is specified.
The < sequence range list> construct specifies the sequence range or ranges of the lines to be copied into the work file or < file title> .
The new sequence numbers of copied lines are determined by assigning an initial value to the first line and incrementing that value for each succeeding line. The initial value must be specified in one of three ways:
• The < base> specifies the value explicitly. The value of < base> must be an
<integer>.
• The NEXT option sets the initial value to the next sequence number that would have resulted from the most recent MOVE, INSERT, RESEQ, or SEQ command. A default value of 100 is used if no such command has appeared since the last MAKE, GET, or DELETE ALL command.
• The END option sets the initial value to the largest sequence number currently in the file, plus the current specified (or default) increment.
The < inc> construct defines the increment value to use for successive sequence numbers in the block. The value of < inc> must be an < integer>. If the increment value is unspecified, the increment value from the most recent MOVE, INSERT, RESEQ, or SEQ command is used. (100 is used if none of these commands have appeared.) The range of new sequence numbers cannot overlap any lines already in the file, nor can the numbers exceed the largest sequence number that may be expressed in the sequence number field.
8600 1500-000
Examples
LANGUAGE Command