diff options
author | Norbert Preining <norbert@preining.info> | 2019-09-02 13:46:59 +0900 |
---|---|---|
committer | Norbert Preining <norbert@preining.info> | 2019-09-02 13:46:59 +0900 |
commit | e0c6872cf40896c7be36b11dcc744620f10adf1d (patch) | |
tree | 60335e10d2f4354b0674ec22d7b53f0f8abee672 /support/vvcode/vvcode.cld |
Initial commit
Diffstat (limited to 'support/vvcode/vvcode.cld')
-rw-r--r-- | support/vvcode/vvcode.cld | 465 |
1 files changed, 465 insertions, 0 deletions
diff --git a/support/vvcode/vvcode.cld b/support/vvcode/vvcode.cld new file mode 100644 index 0000000000..f67fcbf374 --- /dev/null +++ b/support/vvcode/vvcode.cld @@ -0,0 +1,465 @@ +!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! +!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! +!! +!! ARCHIVE HEADER INFORMATION +!! +!! @Digital-Command-Language-Def-file{ +!! FILENAME = "vvcode.cld", +!! VERSION = "1.00", +!! DATE = "", +!! TIME = "", +!! +!! AUTHOR = "Niel Kempson", +!! ADDRESS = "25 Whitethorn Drive, Cheltenham, GL52 5LL, England", +!! TELEPHONE = "+44-242 579105", +!! EMAIL = "kempson@tex.ac.uk (Internet)", +!! +!! SUPPORTED = "yes", +!! ARCHIVED = "tex.ac.uk, ftp.tex.ac.uk", +!! KEYWORDS = "VVcode", +!! +!! CODETABLE = "ISO/ASCII", +!! CHECKSUM = "51492 1481 5732 57976", +!! +!! DOCSTRING = { This is the VVCODE Command Line Definition file for +!! VAX/VMS. It defines the command verbs VVENCODE and +!! VVDECODE. +!! +!! NOTE: the string VVCODE_DIR used in the "image" +!! lines should be replaced by the appropriate +!! physical or logical directory specification +!! where the VVDECODE.EXE and VVENCODE.EXE +!! image files reside. +!! +!! To activate the command verbs, the DCL command +!! +!! SET COMMAND VVCODE +!! +!! should be issued. +!! } +!! } +!! +!! MODULE CONTENTS +!! +!! [tbs] +!! +!! COPYRIGHT +!! +!! Copyright (c) 1991-1993 by Niel Kempson <kempson@tex.ac.uk> +!! +!! This program is free software; you can redistribute it and/or +!! modify it under the terms of the GNU General Public License as +!! published by the Free Software Foundation; either version 1, or +!! (at your option) any later version. +!! +!! This program is distributed in the hope that it will be useful, +!! but WITHOUT ANY WARRANTY; without even the implied warranty of +!! MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU +!! General Public License for more details. +!! +!! You should have received a copy of the GNU General Public License +!! along with this program; if not, write to the Free Software +!! Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. +!! +!! In other words, you are welcome to use, share and improve this +!! program. You are forbidden to forbid anyone else to use, share +!! and improve what you give them. Help stamp out software-hoarding! +!! +!! CHANGE LOG +!! +!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! +!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! + + + +!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! +!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! +!! +!! Define the verb VVENCODE. +!! +!! Parameters +!! +!! INPUT_FILE +!! +!! The file to be read and encoded. This parameter is required +!! (unless the /HELP qualifier is present) and must be a valid +!! VAX/VMS file specification. +!! +!! OUTPUT_FILE +!! +!! The encoded VVE file to be created by VVENCODE. This +!! parameter is optional, but if present, must be a valid +!! VAX/VMS file specification. +!! +!! Qualifiers +!! +!! /DEBUG +!! +!! generate copious debugging information +!! +!! /ENCODING_TABLE=file-spec +!! +!! specify a file containing the 64 character encoding table +!! used to encode/decode the file. The qualifier value is +!! required and must be a valid VAX/VMS file specification. +!! +!! /FORMAT=file_format +!! +!! specify the VVcode file format to be used when reading the +!! file. This qualifier is not normally required as the file +!! format will be determined automatically by the program. The +!! qualifier value is required and must be one of the values +!! defined for the CLD type 'file_format' (defined near the end +!! of this file): DEFAULT, FIXED, STREAM or VARIABLE. +!! +!! /HEADER_FILESPEC=string +!! +!! specify the file specification to be recorded in the VVE +!! file created by VVENCODE, to be subsequently used as the +!! default for the output file by VVDECODE. The qualifier value +!! is required and may be an arbitrary string. The value is not +!! checked or validated by VVENCODE. +!! +!! /HELP +!! +!! request a short summary of the command line syntax for +!! VVENCODE. NOTE: this qualifier invokes a special syntax +!! version of the verb that does not require an input file to be +!! specified. +!! +!! /LOG[=file_spec] +!! +!! specify a file to which status and logging information should +!! be written. The qualifier value is optional, but if present, +!! must be a valid VAX/VMS file specification. If absent, +!! logging information is written to SYS$OUTPUT. +!! +!! /MODE=file_mode +!! +!! specify the VVcode file mode to be used when reading the file. +!! This qualifier is not normally required as the file mode +!! will be determined automatically by the program. The +!! qualifier value is required and must be one of the values +!! defined for the CLD type 'file_mode' (defined near the end +!! of this file): BINARY or TEXT. +!! +!! /OVERWRITE +!! +!! specify that existing files can be overwritten by VVENCODE +!! without first requesting permission. On VAX/VMS, VVENCODE +!! would only request permission if the output file +!! specification included an explicit version number. +!! +!! /RECORD_LENGTH=decimal_number +!! +!! specify the maximum record length to be assumed when reading +!! a fixed or variable length record format file. This +!! qualifier is not normally required as the maximum record +!! length will be determined automatically by the program. The +!! qualifier value is required and must be an integer in the +!! supported for the different file formats (FIXED: 2 - 32767, +!! VARIABLE: 0 - 32765). +!! +!! /SPLIT_SIZE=decimal_number +!! +!! specify the maximum size in kilobytes of VVE file parts +!! created by VVENCODE. The qualifier value is required and must +!! be an integer no less than 4. +!! +!! /TIMESTAMP=time_value +!! +!! specify the timestamp to be recorded in the VVE file created +!! by VVENCODE, to be subsequently used by VVDECODE. The +!! qualifier value is optional, but if present, must be a VMS +!! absolute or combination time. If the qualifier value is +!! omitted the current date and time is used. This +!! qualifier is not normally required as the file timestamp +!! will be determined automatically by the program. +!! +!! /TRANSLATION_FILE=file_spec +!! +!! specify a file containing the rules for translating between +!! two character sets (e.g. ASCII -> EBCDIC). The qualifier +!! value is required and must be a valid VAX/VMS file +!! specification. +!! +!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! +!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! +define verb VVENCODE + image VVCODE_DIR:VVENCODE +! + parameter P1, + label=INPUT_FILE, + prompt="File_to_be_encoded", + value(required, type=$file) + parameter P2, + label=OUTPUT_FILE, + prompt="Output_File", + value(type=$file) +! + qualifier DEBUG + qualifier ENCODING_TABLE, + nonnegatable, + value(required, type=$file) + qualifier FORMAT, + nonnegatable, + value(required, type=FILE_FORMAT) + qualifier HEADER_FILESPEC, + nonnegatable, + value(required) + qualifier HELP, + syntax=VVENCODE_HELP + qualifier LOG + nonnegatable, + value(type=$file) + qualifier MODE, + nonnegatable, + value(required, type=FILE_MODE) + qualifier OVERWRITE, + negatable, + default + qualifier RECORD_LENGTH, + nonnegatable, + value(required, type=$number) + qualifier SPLIT_SIZE, + nonnegatable, + value(required, type=$number) + qualifier TIMESTAMP, + nonnegatable, + value(type=$datetime) + qualifier TRANSLATION_FILE, + nonnegatable, + value(required, type=$file) + + + +!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! +!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! +!! +!! Define the verb VVDECODE. +!! +!! Parameters +!! +!! INPUT_FILE +!! +!! The encoded VVE file to be read and decoded. This parameter +!! is required (unless the /HELP qualifier is present) and must +!! be a valid VAX/VMS file specification. +!! +!! OUTPUT_FILE +!! +!! The decoded output file to be created by VVDECODE. This +!! parameter is optional, but if present, must be a valid +!! VAX/VMS file specification. +!! +!! Qualifiers +!! +!! /DEBUG +!! +!! generate copious debugging information +!! +!! /ENCODING_TABLE=file-spec +!! +!! specify a file containing the 64 character encoding table +!! used to encode/decode the file. The qualifier value is +!! required and must be a valid VAX/VMS file specification. +!! +!! /FORMAT=file_format +!! +!! specify the VVcode file format to be used to create the +!! output file. This qualifier is not normally required as the +!! VVE file specifies the format of the original file, but may +!! be used to override that value. The qualifier value is +!! required and must be one of the values defined for the CLD +!! type 'file_format' (defined near the end of this file): +!! DEFAULT, FIXED, STREAM or VARIABLE. +!! +!! /HELP +!! +!! request a short summary of the command line syntax for +!! VVDECODE. NOTE: this qualifier invokes a special syntax +!! version of the verb that does not require an input file to be +!! specified. +!! +!! /INDEX_FILE=file_spec +!! +!! specify a file containing the index of translation table +!! files to be used for translating between two character sets +!! (e.g. ASCII -> EBCDIC). The qualifier value is required and +!! must be a valid VAX/VMS file specification. This file is +!! used by VVDECODE if the file has been encoded using a +!! different character set and the /TRANSLATION_FILE qualifier +!! was not used to specify the translation table file. +!! +!! /LOG[=file_spec] +!! +!! specify a file to which status and logging information should +!! be written. The qualifier value is optional, but if present, +!! must be a valid VAX/VMS file specification. If absent, +!! logging information is written to SYS$OUTPUT. +!! +!! /MODE=file_mode +!! +!! specify the VVcode file mode to be used to create the +!! output file. This qualifier is not normally required as the +!! VVE file specifies the mode of the original file, but may +!! be used to override that value. The qualifier value is +!! required and must be one of the values defined for the CLD +!! type 'file_mode' (defined near the end of this file): +!! BINARY or TEXT. +!! +!! /OVERWRITE +!! +!! specify that existing files can be overwritten by VVDECODE +!! without first requesting permission. +!! +!! /PAD_CHARACTER=decimal_number +!! +!! specify the value of the character to be used to pad a fixed +!! length format output file to ensure that its length is an +!! exact multiple of the record length. The qualifier value is +!! required and must be an integer in the range 0 - 255. +!! +!! /RECORD_LENGTH=decimal_number +!! +!! specify the maximum record length to be used when creating +!! a fixed or variable length record format file. This +!! qualifier is not normally required as the VVE file specifies +!! the maximum record length of the original file. The +!! qualifier value is required and must be an integer in the +!! supported for the different file formats (FIXED: 2 - 32767, +!! VARIABLE: 0 - 32765). +!! +!! /TIMESTAMP=time_value +!! +!! specify the timestamp to be applied to the output file +!! created by VVDECODE. This qualifier is not normally required +!! as the VVE file specifies the timestamp of the original file. +!! The qualifier value is optional, but if present, must be a VMS +!! absolute or combination time. If the qualifier value is +!! omitted the current date and time is used. +!! +!! /TRANSLATION_FILE=file_spec +!! +!! specify a file containing the rules for translating between +!! two character sets (e.g. ASCII -> EBCDIC). The qualifier +!! value is required and must be a valid VAX/VMS file +!! specification. +!! +!! /UUDECODE +!! +!! specify that the input file is a UUencoded file and should be +!! decoded accordingly. This qualifier is provided to give +!! VVDECODE an element of backwards compatibility. NOTE: this +!! qualifier and the /XXDECODE qualifier are mutually exclusive. +!! +!! /XXDECODE +!! +!! specify that the input file is a XXencoded file and should be +!! decoded accordingly. This qualifier is provided to give +!! VVDECODE an element of backwards compatibility. NOTE: this +!! qualifier and the /UUDECODE qualifier are mutually exclusive. +!! +!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! +!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! +define verb VVDECODE + image VVCODE_DIR:VVDECODE +! + parameter P1, + label=INPUT_FILE, + prompt="File_to_be_decoded", + value(required, type=$file) + parameter P2, + label=OUTPUT_FILE, + prompt="Output_File", + value(type=$file) +! + qualifier DEBUG + qualifier ENCODING_TABLE, + nonnegatable, + value(required, type=$file) + qualifier FORMAT, + nonnegatable, + value(required, type=FILE_FORMAT) + qualifier HELP, + syntax=VVDECODE_HELP + qualifier INDEX_FILE, + nonnegatable, + value(required, type=$file) + qualifier LOG + nonnegatable, + value(type=$file) + qualifier MODE, + nonnegatable, + value(required, type=FILE_MODE) + qualifier OVERWRITE, + negatable, + default + qualifier PAD_CHARACTER, + nonnegatable, + value(required, type=$number) + qualifier RECORD_LENGTH, + nonnegatable, + value(required, type=$number) + qualifier TIMESTAMP, + nonnegatable, + value(type=$datetime) + qualifier TRANSLATION_FILE, + nonnegatable, + value(required, type=$file) + qualifier UUDECODE, + nonnegatable + qualifier XXDECODE, + nonnegatable + disallow UUDECODE AND XXDECODE + + + +!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! +!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! +!! +!! Define an alternative syntax for VVENCODE & VVDECODE so that the user can +!! issue the command VVENCODE /HELP without being forced to specify a file +!! parameter. +!! +!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! +!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! +define syntax VVENCODE_HELP + image VVCODE_DIR:VVENCODE + noparameters + +define syntax VVDECODE_HELP + image VVCODE_DIR:VVDECODE + noparameters + + + +!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! +!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! +!! +!! Define the keywords that can be specified as values for the /FORMAT +!! qualifier. No default value is specified because the value is normally +!! determined from the input file. +!! +!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! +!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! +define type FILE_FORMAT + keyword DEFAULT, + keyword FIXED, + keyword STREAM, + keyword VARIABLE + + + +!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! +!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! +!! +!! Define the keywords that can be specified as values for the /MODE +!! qualifier. No default value is specified because the value is normally +!! determined from the input file. +!! +!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! +!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! +define type FILE_MODE + keyword BINARY, + keyword TEXT |