The following paragraphs describe commands that are exclusive to MARC. The commands FAMILY, FILES, LIST, NEWS, WRU, and so on are MARC commands even though they are similar to CANDE commands.
You cannot direct MARC command output to a printer.
ALLMSG (All Messages)
The ALLMSG command displays messages from the system.
Syntax
- ALLMSG - - - 1
Explanation
The ALLMSG command differs from the SMSG command, described later in this discussion of MARC commands, in that ALLMSG presents a rolling log containing up to 150 of the most recent messages, while SMSG presents only the 23 most recent messages. The ALLMSG command therefore enables you to examine system messages that are not recent enough to still be in the SMSG display. ALLMSG also displays messages such as beginning-of-task (BOT) and end-of-task (EOT) messages. Both ALLMSG and SMSG display the mix numbers of the tasks generating the messages, as well as the times at which the messages were first displayed.
The first screen of messages displayed by the ALLMSG command contains the most recent messages. To see the older messages, scroll back in the log by using the minus (-) action.
The system messages stored for this command are lost during a halt/load, and new
Using Commands
BDIR (Backup Directory)
The BDIR command displays the directory of your printer backup files.
Syntax
- BOI R - , - - - , - - - l
t
JOB SESSION [<sessi on nUmberj=J
L<j ob number>'---'Explanation
The directory of printer backup files includes a list of backup files created under the current session, a different session, or by a specific job.
BDIR
Displays the list of backup files for the current session in the current MARC dialogue.
SESSION
SESSION <session number>
Displays a list of backup files for the current session, or for the specified session if you include a session number. To display the current session number, enter WRU in the Action field of a MARC screen.
JOB
JOB <job number>
Displays a list of backup files for the current job, or for the specified job if you include a job number.
The session number and the job number are the same unless the job originates from WFL, in which case the job is assigned a different number.
BP (Breakpoint)
The BP command suspends execution of a program being tested under the Test and Debug System (TADS).
Syntax
- BP -,---r---~
L<mi x number>~
Explanation
You can use the BP command only during a TADS test session. The command suspends the program being tested and returns control to TADS. For additional information, see
Using Commands
the A Series ALGOL Test and Debug System (TADS) Programming Guide, the A Series COBOL ANSI-74 Test and Debug System (TADS) Programming Guide, or the A Series FORTRAN77 Test and Debug System (TADS) Programming Guide.
BP
Suspends the task (if any) that opened a remote file, either directly or through another sub task.
BP <mix number>
Suspends the specified task. If you do not own or have access to the task, or the system fails to find the task, an error message appears.
?CONTINUE (Continue MARC Processing)
The ?CONTINUE command enables MARC processing to continue ifit was suspended while waiting for a system response.
Syntax
- ? - CONTINUE - - - \
Explanation
?CONT is an acceptable abbreviation for the ?CONTINUE command.
If you are waiting for a response from the MARC software or from BNA, the
?CONTINUE command displays your current MARC screen so that you can continue processing in MARC. This command is useful if you cannot wait for a response.
DIRECTIVE (Define Directives)
The DIRECTIVE command enables you to define your own commands for use with MARC. For more information on this command, see "Using Directive Commands" in Section 8, "Creating Custom Versions of MARC."
FAMILY (Set Family Specification)
The FAMILY command displays or changes your current disk family specification.
Syntax
Using Commands
<family specifications>
-<target family>- = -<substitute family>---~
~ ONLY ---~---~
~ OTHERWISE -<alternate family>:J
<target family>
-<famil y n a m e > - - - ' - - - l
<substitute family>
-<famil y n a m e > - - - l
<alternate family>
-<fami ly name>---~
Explanation
The FAMILY command either changes or displays the disk family specification for the current session. There is additional1y a system default family specification (typically DISK = DISK ONLY) as well as a usercode default family specification. The usercode default specification is created by means of the MAKEUSER utility, and can be different for each usercode.
The FAMILY command is the same in MARC as in CANDE, except that in MARC you cannot abbreviate the command name to FA.
FAMILY
Displays the family name or names currently in effect for the session.
FAMILY.
Deletes any family specification made in the current session and returns to the system default specification.
FAMILY *
Deletes any family specification made in the current session and returns to the usercode default specification.
<target family> = <substitute family> ONLY
Searches the substitute family if a request is made for an existing file on the target family.
Using Commands
<target family> = <substitute family> OTHERWISE <alternate family>
Searches the substitute family if a request is made for an existing file on the target family. If the system fails to find the file on the substitute family, the search continues on the alternate family.
FI LES (Display File Titles)
The FILES command displays the names of the files in a specified directory, or in your default directory.
Syntax
<directory name> - - - - I
<fil e name> - - - i ( --<usercode>-- )
(--=--)
ON --<family name>
~~L--:----<-d'-'r-e-c-to-r-y--le-v-e-l-n-u-m-be-r->--J~---~
<directory name>
--~---~---~~
L
L i
--<usercode>-- )~
I LL/ll-=---lJ
\-r<name constant> I / L- # --<string primary>~~L
;
--<-s-t-r'-'n-g--pr-i-m-a-ry->-J~---i<file name>
( / - - - ,
-.---,---''--/12\-r<name cons tant>---,--.--'---l
t i
--<usercode>-- )-1
L- # --<string primary>~Explanation
The FILES command displays the names of files on a disk family, or displays
information about a particular file. The command names FILES, FILE, and PD are all synonyms in MARC.
If no files matching your specification are found on the designated (or default) family, the system displays the message:
No file(s) were found on <family name>.
Using Commands
FILES
Displays the names of all your files on the first (or only) disk family associated with the current MARC dialogue.
FILES <directory name>
Lists the names of files under the designated directory on the first (or only) disk family associated with the current MARC dialogue.
FILES <file name>
Displays information about the designated file if it exists on the first (or only) disk family associated with the current MARC dialogue. The display includes the following information about the file:
•
File name•
File type•
Date and time of file creation•
Date and time of last access•
Date and time of last alteration•
File size in sectors•
File security type•
Archive records for the file, if any FILES «usercode»=Displays the names of all files under the specified usercode on the first ( or only) disk family associated with the current MARC dialogue.
FILES (=) FILES (=)=
Displays the names of all files under all usercodes on the first (or only) disk family associated with the current MARC dialogue. You can use the (=) = form of this command only if your usercode has SYSTEMUSER status. See Section 7, "Controlling System Security," for more information on usercode privileges.
ON <family name>
Causes files to be listed or searched for only on the specified family.
: < directory level number>
Specifies how many levels of a directory below the directory name are to be displayed.
If you specify a directory name containing x name constants and a directory level number ofy, each file name in the directory is displayed out to the first (x
+
y) levels.Using Commands
Examples
The following examples illustrate selected uses of the FILES command.
• If your current FAMILY statement is FAMILY DISK = ACCTS OTHERWISE UTILS, the following command lists all the file names under your usercode on the family ACCTS:
FILES
•. The following command lists information about the file named HOUSTON under the usercode SMITH on the family SALES:
FILE (SMITH)HOUSTON ON SALES