Safeguard Reference Manual (G06.24+, H06.03+ )

SAFECOM Session-Control Commands
Safeguard Reference Manual—520618-013
4-29
Continuation Character
Example
Comment lines are particularly useful in command files, as an example, to annotate the
way a file works.
This example demonstrates the use of the comment line with the INFO command:
=OBEY --year-end report-- data.sales.report1
=--sent to operations line printer--
=OUT $s.#lp
=--report on all admin users--
=INFO USER admin.* , DETAIL
=OUT --redirect output to the home terminal--
Continuation Character
The ampersand character (&) is used to indicate that a SAFECOM command line is
continued on the next line. The ampersand must be the last character to appear in the
line to be continued. You can break the command to be continued at any point.
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.
Example
In the following example, the & continuation character allows for continuation of a
command over three lines:
=ALTER DISKFILE $data.user2.reports, AUDIT-ACCESS-FAIL all,&
=ACCESS 12,56 *; (test.sharon, software.arthur, &
=software.karl) (read, write)
In the example, an ALTER DISKFILE command alters the authorization record for the
disk file $data.user2.reports. The ALTER 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.