3-4
Syntax
- ADD , r , r
-L & L COMPARE~ L & L CATALOG~
LAND' ~ VERI FY ~ LAND ~ BACKUP ~
~
[
~
~ • I[ /1\- FROMSTART I ]
/l\-<transfer service>~
~ I _:__________________ I
~
; -<task attributeaSSignment>~
Explanation
The ADD command is similar to the COpy command. It copies files between disks and tapes. For a more detailed explanation and the complete syntax, see the COpy command in this section.
The ADD command has the following effects based on whether a disk or tape destination is specified:
• For a disk destination, the ADD command only copies those files that are not already resident on the specified disk destination.
• For a tape destination, the ADD command has the same effect as a COpy command that specifies a tape destination.
The ADD command is particularly useful for adding a directory of files to a disk where some of the files are already resident and are to be preserved.
Example
The following example copies files under the directory Z/ = from tape T to disk R and to DISK. Any files already resident on the destination volumes are not copied. Note that different files might be copied to R and DISK, depending on what is already resident on each destination volume before the ADD is done.
ADD Z/= FROM T(KIND=TAPE) TO R(KIND=DISK), TO DISK;
8600 1500-000
ALTER Command
ALTER
Syntax
f--- ALTER
~<file
<directory name> title> ] <file attribute assignment>--'---l<file attribute assignment>
L- =
-<Boolean expression>~-- =
-<string>ASEIO - = -<string>
FACTOR -- = -<number>
RITYGUARO --
=
-<file title~RITYTYPE --
=
-<file mnemonic primary>--RITYUSE -- = -<file mnemonic primary>---ITIVEOATA~ = -<Boolean express i on>~
INFO -- = ~<inte g er>
The ALTER command changes the file attributes of a disk file.
Table 3-1 shows the file attributes that can be changed through the ALTER command.
Table 3-1. File Attributes for the ALTER command
File Attribute Meaning
APL When set to TRUE, this file attribute specifies that only a program whose code file also has its APL attribute set to TRUE can access the file. If the APL attribute is set to FALSE, the file can be accessed by a program regardless of the APL attribute value in the program code file.
LOCKEDFILE When set to TRUE, this file attribute prevents disk files from being removed or replaced, and the file name from being changed. However, the locked file can be opened and updated, and the file attributes can be changed. When set to FALSE, this attribute permits files to be removed and changed.
NOTE Stores a message of up to 250 characters to be printed on the banner page preceding the printer file, punch file, or disk file. The default value is a null string.
RELEASEID Specifies or determines the Mark release level of the file.
SAVE FACTO R Indicates the expiration date of a file in terms of the number of days past the creation date.
continued
ALTER Command (cant.)
3-48
Table 3-1. File Attributes for the ALTER command (cant.)
File Attribute Meaning
SECURITYGUARD Identifies the guard file to be invoked for the file if the SECURITYTYPE attribute is assigned GUARDED or CONTROLLED. For more information about guard files, refer to the A Series Security Features
Operations and Programming Guide.
SECU RITYTYPE Specifies the usercodes, other than the owner of a file, that can access a physical file. The SECURITYTYPE attribute can have a value of PRIVATE (default), PUBLIC, GUARDED, o"r CONTROLLED.
•
PRIVATE files can be accessed or overwritten only by their owners and privileged users.•
PUBLIC files can be accessed by tasks with any usercode, as limited by the setting of the SECURITYUSE attribute.•
GUARDED files can be accessed by the owner, however,non privileged users and programs are granted access as defined by the guard file. The guard file, which define the access rights to files, must be examined before access to a disk file is granted.
•
CONTROLLED files can be accessed after the guard file is examined and access to your disk file is granted. If you are not defined in the guard file, you do not have access to the file.SECURITYUSE Specifies how a physical file that is protected by security can be accessed by nonprivileged users using nonprivileged programs. This attribute can have a value of 10 (default), IN, or OUT. When a PUBLIC file is accessed by a task with a usercode that differs from the·
FAMILYOWNER, the SECURITYUSE attribute permits the following actions based on its value:
•
A value of 10 permits reading, writing, overwriting, and purging.•
A value of IN permits reading, but not writing, overwriting, or purging.•
A value of OUT permits writing, overwriting, or purging, but not reading.SENSITIVEDATA When this file attribute is set to TRUE, it causes the disk or pack areas assigned for a file to be overwritten with an arbitrary pattern before the disk space is returned to the system for reallocation.
USERINFO Saves site- or application-specific information.
Refer to the A Series File Attributes Programming Reference Manual for more information about the file attributes that can be specified in the ALTER command.
Example
ALTER FILEX (LOCKEDFILE)
8600 1500-010
ALTER Command (cant.)
ALTER MYFILE, *SOURCE/AFILE (LOCKEDFILE=TRUE, SECURITYUSE=IN) ALTER FILEY, MYFILE/= (SENSITIVEDATA, LOCKEDFILE),
FI LEX (SAVEFACTOR=30, NOTE= II Banner Page", LOCKEDFI LE)
ALTER Command (cant.)
3-40 . 8600 1500-010
APASSWORD Command
APASSWORD
Syntax
- APASSWORD ---~
< old apassword>
- < p a s s w o r d > - - - j
< new apassword>
- - < p a s s w o r d > , - - - 1
Explanation
The AP AS SWORD command allows the accesscode password to be changed for the current accesscode of a session.
To change accesscode passwords, all or part of the required information can be entered with the AP ASSWORD command. Any information not initially provided is requested by CANDE. For verification purposes, the < new apassword> (new accesscode password) must be entered twice.
To provide complete information, the following would be entered:
APASSWORD <old apassword> <new apassword> <new apassword>
This form changes the user's accesscode password from the current accesscode password ( < old apassword> ) to a new accesscode password ( < new apassword> ).
On InfoGuard systems with the SEC OPT CLASS option set to Sl or higher, the old and new passwords must be entered on lines that are separate from the command and from each other.
If AP AS SWORD or any other subset of the complete command is entered, CANDE prompts the rest of the command. '
For further information about accesscode passwords, refer to the "User Identification and Logging On" in Section 1, "Gen'eral Information."
Any CANDE schedule sessions inherit the accesscode of the CANDE session. The AP ASSWORD command is not valid within a CANDE schedule session. If a schedule session contains an ACCESS command with an invalid accesscode, the schedule session is aborted.
CANDE includes the accesscode in all log records about a session, particularly in log-on and log-off records.
APASSWORD Command (cont.)
3-6
Examples APASSWORD ESR
#ENTER NEW ACCESSCODE PASSWORD PLEASE.
EPR
#RE-ENTER NEW ACCESSCODE PASSWORD PLEASE.
EPR
#
APASSWORD OLDP.W
=
NEWPW NEWPW#
8600 1500-000
BACKUPPROCESS Command
BACKUPPROCESS
Syntax
- BACKUPPROCESS --,---~-.,...---_r_---~
L<di rectory name>-.J L ON -<fam; ly name>-.J
- REMOVE ]
- OPTION -<option list>
Explanation
The BACKUPPROCESS command calls the Backup Processor utility. Through this utility, backup files can be copied to disk, listed on a terminal, printed, or removed.
The < directory name> specifies the directory that is to be searched for backup files.
Only backup files found in this directory are presented to the user.
The ON < family name> construct allows the specification of an arbitrary disk family that is to be searched.
If: REMOVE is entered, all files in the directory are removed.
If: REMOVE is not entered, the Backup Processor utility enters interactive mode.
The: OPTION < option list> construct specifies Backup Processor utility options.
Refer to the Backup Processor utility documentation in the A Series Printing Utilities Operations Guide for the complete command syntax using the :OPTION or :REMOVE options.
Examples BACK
#RUNNING 1101
#?
A15 Backup Processor (37.000.000).
You have one backup file in your directory.
Please enter a command or HELP for a list of commands.
File # 1:
Created on:
Job:
Task:
Print Status:
PrinterKind:
*BO/0001090/0001100/0000UTFILE ON PACK 09:53 ON 09/01/89
1090 "Session"
1100 (UZER) IICANOE WRITER II
Not yet queued Length: 202 lines
IP/LP PrintCopies: 1
BACKUPPROCESS Command (cont.)
Displays the available HELP options.
Displays the last page of a backup file.
Terminates a Backup Processor session.
Removes a backup file or directory.
Restores the current text page.
Selects a backup file.
Displays information about a backup file.
Scrolls forward through the file.
Scrolls backwards through the file.
Enter HELP <command> for more information about a command.
*BD/0001090/0001100/0000UTFILE ON PACK 09:53 ON 09/01/89"
1090 "Session"
1100 (UZER)"CANDE WRITER"
Print Status: Not yet queued Length: 202 lines
Remove after printing Not Specified
BACKUPPROCESS Command (cant.)
back :rem
#RUNNING 4897
> Remove in progress ...
#4897 PK67 *BD/0004889/0004894/0000UTFILE REMOVED ON PACK
#4897 PK67 *BD/0004889/0004895/0000UTFILE REMOVED ON PACK The backup files from SESSION 4889 have been removed.
2 files removed.
#
BIND Command
BIND
3-10
Syntax
-- liIND ---~
~1f-
/1 \-<source fi 1 e ti tle>---.,---L-~
/1\- AS I I <remote file name>---~---~__l _$-.1
SYNTAX ---'--~---I
/1\~<standard compiler>
r- WITH -<compi 1 er name>--~
~ WITH -- * --<compiler name>
L : -<compi 1 er type>----l·
ON --<family name>
~~~---~---~
LL ;
-r<code file task attribute>r- C.OMPILER I <task equation list>~
L-<standard compiler>-.I
< source file title>
--<file title>---~
< remote file name>
--<file name>---~
Explanation
The BIND command is similar to the COMPILE command except that if a compiler is not specified, the BINDER is invoked. For further inforrnation, refer to the COMPILE command in this section.
Examples BIND
#BINDING 3291
#ET=1:13.9 PT=6.3 10=60.9 BIND ALGOLjPROG WITH ALGOL
#BINDING 3314
#ET=1:19.6 PT=8.9 10=50.6
8600 1500-000
BYE
BYE Command
Syntax
- BYE _ _ _ ~ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ ~0'6
Explanation
The BYE command terminates the current Cfu~DE session and disconnects dial-up lines.
If an unsaved work file exists at the time BYE is entered, CANDE displays
#REMOVE OR SAVE WORKFILE
The previous message indicates the presence of the unsaved work file. The work file must be removed or saved. Then the BYE command must be re-entered before the session will terminate.
System resource usage statistics are provided on. termination of the session. The session number, elapsed time of session (ET), processor time consumed (PT), I/O tinle consumed (10), usercode, current time, and the date are printed in the following format:
#END SESSION <session number> ET=<time> PT=<time> IO=<time>
#USER = <usercode> <time> <date>
If a chargecode is used for the session, then the chargecode is printed following the usercode identification. If an accesscode is used, it is printed following the chargecode.
Example BYE
#
#END SESSION 3003 ET=1:18:19.6 PT=1:08.9 10=1:02.0
#USER = UZER 11:27:06 04/20/78
CHANGE Command
CHANGE
3-12
Syntax
- r CHANGE --r-"-.---,-<new fi 1 e name>
L TITLE
~
, --<change files>< new file name>
--<file name>---~
< change files>