-*-TAGS-*-  File: pip, Node: Top, Up: (DIR)Utilities PIP (Peripheral Interchange Program) performs file transfer, conversion, directory listing, and other functions. * Menu: * Wild Cards:: * Defaults:: * Output Defaults:: * Input Defaults:: * Switches:: * Dates:: * ~Privilege:: * Transfers:: * Rms Conversion:: * Deletions:: * Renames:: * Directories:: * Zeroing:: * MULTI-VOLUME:: * GENERAL:: * INDIRECTS::   File: PIP, Node: Wild Cards, UP: Top Wild card specifications for file names and extensions: PIP accepts the asterisk (*) in place of either file name, extension, or both. It is used as follows: FILE.* All files with name 'FILE' and any extension. *.EXT All files with extension 'EXT' *.* All files PIP accepts the question mark (?) in place of any character in the name or extension. FILE.EX? All files with name 'FILE' and 'EX' as first 2 characters of extension and any character (or blank) as third FILE??.EXT All files with 4, 5, or 6 character names, the first 4 of which are 'FILE', and with extension 'EXT' FILE??.E?? Same as above for name and with 'E' as the first character of the extension AB?.EXT All files with 2 or 3 character names starting with 'AB', and with extension 'EXT' PIP accepts both * and ? in a file specification: FILE??.* All files with name matching 'FILE??' and with any extension *.EX? All files with name matching '??????' and with extension matching 'EX?' PIP will accept an asterisk (*) in either the project number or programmer number for input and output files. Input files must come from either disk or magtape if a wild card is specified in the [ACCT] field.  File: Pip, Node: DEFAULTS, Up: Top In absence of a full file specification, the defaults are: Spec Default Meaning null *.* All files * *.* All files *. .* All files with null extensions . *. All files with null extensions .EXT *.EXT All files with extension matching 'EXT' (may be wild) and any name FILE FILE.* All files with name matching 'FILE' (may be wild) and any extension  File: Pip, Node: OUTPUT DEFAULTS, Up: Top If missing: PIP uses: [ACCT] Current user account DEV: Device 'DK:' NAME Input file name (i.e. '*' assumed) .EXT Input extension (i.e. '*' assumed) Input protection (if disk) or current assigned default Entire spec Current terminal (KB:)  File: Pip, Node: INPUT DEFAULTS, Up: Top If missing: PIP uses: Entire spec Skips this specification DEV: Immediately previous specification. If none, 'DK:' is used. Note that ':' means the public structure. [ACCT] Current user account NAME All files .EXT All matching files with any extension (To specify explicitly null extension, use '.') Currently assigned default protection (Relevant only for renames)  File: Pip, Node: SWITCHES, Up: Top These are general PIP switches. For switches relating to specific operations, obtain help on the operation. * Menu: * Individual/Query:: * Logging Operations:: * Magtape:: * Print version:: /IN /Q Inspects eligible files; type 'Y' to transfer or anything not beginning with 'Y' to omit. Type CTRL/Z to quit command. Using :S to modify this switch (i.e. /IN:S or /Q:S) will cause the file size, protection code, access date, and creation date to be printed in addition to the file name. /LO /WATCH Log all operations on the terminal /NO /RW:NO Disable rewind of magtape /HA Stop magtape wild card search as soon as a mismatch is found (rather than spinning to end of tape) /VE /IDE Print current PIP.SAV version number  File: Pip, Node: DATES, (include under switches), Up: Top PIP offers several date switches, which can be used to perform operations selectively on file dates. When specifying a date, omitting the '-yy' means this year; omitting the ':dd-mmm-yy' means today. More than one date switch is the AND of conditions (nothing matches if high limit < low limit) /AF /AF:dd-mmm-yy Include files created after (not on) date /BE /BE:dd-mmm-yy Include files created before (not on) date /SI /SI:dd-mmm-yy Include files created since (on or after) date /UN /UN:dd-mmm-yy Include files created until (before or on) date /ON /ON:dd-mmm-yy Include files created on specified date /TO Include files created today /CREATION Use the creation date for limit checking with the date switches. This is the default action, but may be changed by the system manager. /DLA Use date of last access for limit checking with the date switches.  File: Pip, Node: ~PRIVILEGE, Up: Top General switches available for privileged PIP users are: /LOCK Lock job into memory during command line /PRIO Execute command line at special run priority  File: Pip, Node: TRANSFERS, Up: Top If no option is specified on file transfer, normal copy mode transfer is performed, i.e. block by block, preserving attributes. ASCII or Formatted Binary conversion is automatic when transferring RMS to non-disk. /BL Block by block transfer (normal default). Used to override automatic conversion when copying RMS files to non-disk. /AS Performs ascii conversion during file transfer, all imbedded and trailing nulls are deleted. /CL /CL:n Set cluster size of output file to n. Must be adjacent to output file. If absent on disk-to- disk, cluster size is preserved. The clustersize switch will be ignored on ANSI format magtapes. /MO /MO:n Set mode for open. Must appear adjacent to file name. (Note: /MO:16 is disk contiguous file.). The mode switch will be ignored on ANSI format magtapes. /PO /PO:n Create output file at disk DCN n. Not meaningful when specified on an input file. This switch must be adjacent to the file name. /SI /SI:n Pre-extend output file to size n. Not meaningful when specified on an input file or a non-disk file. This switch must be adjacent to the file name. /RTS /RTS:RTSNAM Set the output files' run-time system name to RTSNAM. If this switch is not used PIP will set the RTS name to that of the input file if the input comes from a file structured disk device, or the first run-time system whose runnable ex- tension matches the extension of the output file (PIP will also create the file with a compiled protection code in this case), or to the name of the run-time system under which PIP is running if one of the two above conditions are not met. If there is no output file specification PIP will rename the run-time system of the input files to RTSNAM. /GO /IG Ignore 'USER DATA ERROR ON DEVICE', and 'MAGTAPE RECORD LENGTH ERROR' errors. /HE Used alone to print this help message /UP Update file in place (create new file if none) /EX /AP Append input file to output file (extend file). If the file does not exist a warning message will be printed and the file will be created. /PR Protect any existing output file; give error if output file already exists. If the file is found to exist a warning is printed. If :NO is appended to the switch (/PR:NO) no warning message will be printed. /AC For disk input, change last access date to today's date. Default is to preserve last access date. Last access date is updated regardless of whether or not the disk is 'DATE OF LAST WRITE'. /NE For disk output, create new file with today's date. Default is to preserve creation date and time. /RETAIN For disk output, preserve the file's creation and access dates, and creation time. This is the default mode of operation but may be changed by the system manager. /NOATT Instructs PIP not to write file attributes to the output file. This switch is only meaningful for disk, or ANSI format magtape output files. /BSIZE /BSIZE:n Used to specify a non-standard block size for file transfers to magnetic tape. 'n' is the block size in bytes to be output. 'n' must be a positive even integer from 18 to 4096. For ANSI format magtapes intended for interchange with foreign operating systems, the block size should not exceed 2048. For interchange with RT11 operating systems the default block size of 512 bytes should be used.  File: Pip, Node: RMS CONVERSION, Up: Top PIP will perform conversion of files to and from RMS format. /RMS On input file, force conversion from RMS format to either formatted ASCII or formatted binary, determined automatically. This conversion is automatic when transferring to non-disk. On normal disk-to-disk transfers, attributes are copied. On output file, force conversion from formatted ASCII or formatted binary to RMS variable length record file. Cannot appear on both input and output files. /RMS:FA Like /RMS, but use formatted ASCII conversion /RMS:FB Like /RMS, but use formatted binary conversion /RMS:FTN For input, force conversion from Fortran carriage control to formatted ASCII. This conversion is automatic for output to non-disk devices. It must be used to force conversion to formatted ASCII output to disk devices. /RMS:PRN For input, force conversion from Print format to formatted ASCII. This conversion is automatic for output to non-disk devices. It must be used to force conversion to formatted ASCII output to disk devices. /RMS:IM For input, like /RMS but do no data conversion (Do not remove record lengths from variable length records; do not remove padding bytes)  File: Pip, Node: DELETIONS, Up: Top File deletion is specified by including /DE in the command. Rules for forming file names are the same as for the input side of a transfer operation. Using the /WO switch in conjunction with /DE writes zeros on the file before deletion. /WO applies to all files being deleted. (/ER and /WI are synonyms for /WO.) If the /DE is postfixed with :NO (/DE:NO) PIP will not print a warn- message if a file to be deleted does not exist. If the file has the privileged bit set in the protection code PIP will write zeros on the file, rename the file to a non-privileged protection code, and then delete it. This action has two benefits, PIP can zero the file faster than the file processor by writing more than one block at a time, and the file processor will not be tied up during the zero operation.  File: Pip, Node: RENAMES, Up: Top File rename is specified by including /RE in the command. Rules for forming file names are the same as for the input side of a transfer operation. The input files are renamed to have the output file name. For rename commands, device and account on input are used on output. If input is null, all files in current account on public structure are renamed. To simply change protection code, include the new protection on the input file and omit the output file specification. (E.g. FILE.EXT<40>/RE changes only the protection code)  File: Pip, Node: DIRECTORIES, Up: Top @_PIPDIR  File: Pip, Node: ZEROING, Up: Top To zero a device directory, include the /ZE switch. Do not specify a file name (except for ANSI magtape, where the file name is the volume label). Only privileged users can zero another account on disk. Zeroing magtapes: The below switches can be used with the /ZE function for magtapes. /DEN:n Set the density of the magtape to n before zeroing. /PAR:ODD Set the parity of the magtape to ODD before zeroing. /PAR:EVEN Set the parity of the magtape to EVEN before zeroing.  File: Pip, Node: MULTI-VOLUME, Up: Top PIP provides support for multi-volume ANSI magtape. When input is from an ANSI magtape and an end-of-volume condition is detected, PIP will rewind and offline the current drive. PIP will then prompt for the drive where the next volume may be found. When output is to an ANSI format magtape and a "No room for user on device" error is detected PIP will write end-of-volume labels on the output, rewind, and offline the drive. PIP will then prompt for the drive where the next volume may be found. The response to these prompts must be a legal magtape unit specification. Therefore, logical device names may be used. Furthermore, if a file name is also specified it will be used to check against the volume identifier for the new volume. Example of legal device specifications: MT0: Will look on drive MT0: for the next volume. TAPE: Is legal only if TAPE is a logically assigned device name equated to a physical magtape unit. MS1:LAUREN Will look on drive MS1: for the next volume and only accept the tape if its volume identifier is "LAUREN".  File: Pip, Node: GENERAL, Up: Top Only 6 input specifications can appear per command line. If there is only one input file per output file and the transfer is a block mode (/BL) disk to disk transfer PIP will open the output file in conditional contiguous mode if the input file is contiguous. If a conditional contiguous mode is specified on an output file and the resulting file cannot be created contiguously PIP will print a warning message to inform you of the status of the output file. Any line starting with a semi-colon ';' will be ignored, this allows for comment lines in indirect command files.  File: Pip, Node: INDIRECTS, Up: Top To execute PIP commands in an indirect command file, type '@' and the file specification as follows: @[ACCT]DEV:FILE.EXT Defaults are current account and extension 'CMD'. Nesting of command files is limited by the current memory size that PIP is running with (approximately 1500 levels of nesting for 28K user space). Since the indirect command files use buffer space which would normally be used for file transfer operations it is advisable not to nest indirect command files too deeply. Indirect command files can only be nested if the current command file is file-structured disk resident.  TAGS: :SGAT Top:15 Wild Cards:440 DEFAULTS:1742 OUTPUT DEFAULTS:2186 INPUT DEFAULTS:2504 SWITCHES:2960 DATES:3754 ~PRIVILEGE:4706 TRANSFERS:4907 RMS CONVERSION:8314 DELETIONS:9555 RENAMES:10413 DIRECTORIES:11001 ZEROING:11053 MULTI-VOLUME:11584 GENERAL:12721 INDIRECTS:13348