DataMuseum.dk

top - download

    Length: 4591 (0x11ef)
    Types: HLP, TextFile
    Names: »CLI.HLP«

└─⟦24d56d853⟧ Bits:30000744 8mm tape, Rational 1000, DFS, D_12_6_5 SEQ293
    └─ ⟦this⟧ »CLI.HLP« 
└─⟦9031b0687⟧ Bits:30000407 8mm tape, Rational 1000, DFS, D_12_7_3
    └─ ⟦this⟧ »CLI.HLP« 

TextFile

CLI

The CLI is the I/O Processor's Command Line Interpreter.  It is used
to invoke programs, create files, delete files, display files, list
files, set the time and display the time.  The CLI makes use of the
DFS macro user interface with which you should be familiar.

The CLI accepts the following commands:

    Command            Description
    ---------        --------------------------------------------
    COPY             copies data from one file into another file.
    CREATE           creates a file.
    DELETE           deletes a file.
    DIRECTORY        list files matching a given file specification.
    LOCAL            returns operations to the local console.
    PRINTER          enables/disables hardcopy of console output.
    REMOTE           transfers operations to the diagnostic moden.
    RENAME           changes the name of a file.
    TIME             display/change the time.
    TYPE             displays the contents of a text file.



The COPY command creates a new file and copies the contents of an
existing file into the new file.  Command syntax is:

    CLI> copy existing_file new_file

The new file must not already exist.  If any disk errors are encountered
the command is aborted but the output file is not deleted, its contents
are indeterminant.

Switches:
    /D            delete the output file if it already exists.  

    CLI> copy/d existing_file new_file
\f



The CREATE command creates a file.  Command syntax is:

    CLI> create new_file

The new file must not already exist.

Switches:
    /D               Delete the file if it already exists
    /SIZE=n          CREATE a file of n pages.  Default = 1.
    /CONTIGUOUS      CREATE the file with CONTIGUOUS disk space.
    /I               Allow the user to enter text into the file.

    CLI> create/d/size=4/contiguous/i new_file
    )This data will be placed into the file new_file.
    ))

    Note:   The final character typed is a single ")" character
        on a line by itself.  This terminates input and
        closes the file.



The DELETE command deletes all existing files matching a given file
specification.  Command syntax is:

    CLI> delete file_spec

Switches:

    /V               Display the name of each file as it is deleted
    /C               Confirm that each file is to be deleted by
                        asking the user.

    
The DIRECTORY command is used to display information about all files matching
a given file specification within the diagnostic file system.  Command syntax
is:

    CLI> directory file_spec

The size and creation time of each file matching the file_spec is displayed
along with a summary of the total number of files and total number of disk
pages.

Switches:
    /FULL   Causes information from the file's File Control Block to be
        displayed.  This includes file attributes, allocation, and
        disk address information.



The LOCAL command is issued to a remote R1000 when customer support wishes
to return control of that system to the local personnel.
\f



The PRINTER command is used to enable or disable hardcopy output of all
operations console transactions.  Command syntax is:

    CLI> printer on line_number
    CLI> printer off

Line_number is the R1000 port number to which a line printer is attached.
The printer should be on-line and should not use any software flow-control
protocol.  Hardware flow-control is permitted.



The REMOTE command is used by local personnel to transfer operations of an
R1000 to Rational's remote support center.



The RENAME command is used to change the name of an existing file.  Command
syntax is:

    CLI> rename old_file new_file

Old_file must exist, new_file must not.

Switches:
    /D            Delete the new_file if it already exists



The TIME command may be used to display or set the time.  It has immediate
effects on the systems battery-backed-up clock/calendar.  Command syntax is:

    CLI> time
    CLI> time hh:mm:ss dd-mon-yy

    HH        Hours since midnight in military (24 hour) format
    MM        Minutes
    SS        Seconds
    DD        Day of the month
    MON       One of JAN,FEB,MAR,APR,MAY,JUN,JUL,AUG,SEP,OCT,NOV,DEC
    YY        Last two digits of the year

Remember the DFS displays the time to within only 2 second granularity.
The time command will set the time to the exact second.



The TYPE command may be used to display the contents of all files matching
a given file specification.  Command syntax is:

    CLI> type file_spec

Switches:
    /V            Display the name of each file prior to its contents