Safeguard User's Guide (G06.24+, H06.03+)

Working With SAFECOM
Safeguard User’s Guide—422089-009
7-4
Continuing Commands From One Line to the Next
The comments "Interactive, OUT = IN" in the display indicate an interactive session.
(The OUT file is the same as the IN file.)
Continuing Commands From One Line to the Next
A single SAFECOM command or multiple commands separated by semicolons can
span two or more command lines if you end each continued line with an ampersand
(&). The ampersand is the command-line continuation character.
You can use the ampersand to enter a single command string across any number of
command lines, but the total number of characters in the entire command string cannot
exceed 528.
You can break a command at any point. In the following example, the ADD DISKFILE
command uses two ampersands to span three command lines. The first ampersand
falls between two disk-file attributes (AUDIT-ACCESS-FAIL and ACCESS). The
second ampersand is embedded in the ACCESS specification.
For example:
=ADD DISKFILE $data.sales.report1, AUDIT-ACCESS-FAIL all,&
=ACCESS 8,7 *; (mkt.jane, software.blane, software.karl)&
=(read, write)
=INFO DISKFILE $data.sales.report1, DETAIL
This display shows:
In this example, the ADD command adds an authorization record for the disk file
$data.sales.report1 to the Safeguard object database. The ADD DISKFILE command
includes an AUDIT-ACCESS-FAIL specification and four access control list entries.
Semicolons separate the elements of the ACCESS specification. Commas separate
other command elements.
The INFO DISKFILE command displays a detailed report for the disk file
$data.sales.report1. The display includes the access control list for this file, the four
auditing specifications, and four special disk-file attributes.
Note. Do not put a semicolon within a comment because it terminates the line and causes the
remainder of the comment to be treated as a SAFECOM command.
LAST-MODIFIED OWNER STATUS WARNING-MODE
$DATA.SALES
REPORT1 15JUL05, 14:46 8,7 THAWED OFF
001,069 R,W
001,098 R,W
008,007 R,W,E,P, O
033,104 R,W
AUDIT-ACCESS-PASS = NONE AUDIT-MANAGE-PASS = NONE
AUDIT-ACCESS-FAIL = ALL AUDIT-MANAGE-FAIL = NONE
LICENSE = OFF PROGID = OFF CLEARONPURGE = OFF PERSISTENT = OFF
TRUST = OFF
(assumes H-series system)