Safeguard Reference Manual (G06.29+, H06.08+, J06.03+)

SAFECOM Session-Control Commands
Safeguard Reference Manual — 520618-030
4 - 29
Continuation Character
--
(two hyphens) are the delimiters that separate the command from the comment.
any-phrase
is any phrase or descriptive remark that follows the delimiter. The phrase cannot
contain -- (two hyphens).
end-of-line
the carriage return is the end-of-line terminator. Alternately, the two hyphens
can be eliminated as delimiters if the end-of-line terminator is included after
your comment in any-phrase. However, the comment line must end with either
the delimiters or the end-of-line 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 $dat
a.user2.reports. The ALTER DISKFILE command includes an AUDIT-
ACCESS-FAIL specification and four access control list entries. Semicolons separate