Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

Parameters

Command Qualifiers

Examples

/FILE_NAME

/LIST

/OBJECT

/SYMBOLS

/TEXT

HELP MESSAGE — VMS 5.0

  Invokes the VMS Message Utility (MESSAGE) to  compile  one  or  more
  files of message definitions.  For a complete functional description
  of the Message Utility, including more information about the MESSAGE
  command  and  its  qualifiers,  see  the VMS Message Utility Manual.

  Format:


    MESSAGE  file-spec[,...]

Additional information available:

ParametersCommand QualifiersExamples

Parameters

 file-spec[,...]

  Specifies one or more message files to be compiled.  If you  do  not
  specify  a file type for an input file, the MESSAGE command uses the
  default file type of MSG.

  You can specify more than one input file.  If you separate the  file
  specifications  with  either  commas  or  plus  signs, the files are
  concatenated and compiled as a single input file,  producing  single
  object and listing files.  If you specify SYS$INPUT as the file-spec
  parameter, the Message Utility input files must follow  the  command
  in  the  input  stream.   In  this case, both the object module file
  (given by the /OBJECT qualifier) and the listing file (given by  the
  /LIST qualifier) must be explicitly named.

  Wildcard characters are allowed in the file specification.

Command Qualifiers

Additional information available:

/FILE_NAME/LIST/OBJECT/SYMBOLS/TEXT

/FILE_NAME

 /FILE_NAME=file-spec
 /NOFILE_NAME

  Controls whether or not  the  object  module  contains  an  indirect
  pointer  to  a file of messages.  The default is /NOFILE_NAME, which
  means that all compiled messages are in the object module.  You  may
  specify  a compiled message file with /FILE_NAME=file-spec.  In this
  case, the object module that is created contains an indirect pointer
  to the file you name.  At execution time, the messages are sought in
  the file rather than in memory.  Thus, you can  update  the  message
  file  specified  by the /FILE_NAME qualifier without recompiling the
  message source file and relinking your program.

  Whenever you specify /FILE_NAME, /NOTEXT is implied.  The /FILE_NAME
  qualifier  requires  that  the  /OBJECT  qualifier  be explicitly or
  implicitly in effect.

  At execution time, the default device and directory are SYS$MESSAGE,
  and the default file type is EXE.

  No wildcard characters are allowed in the file specification.

/LIST

 /LIST[=file-spec]
 /NOLIST

  Controls whether  an  output  listing  is  created,  and  optionally
  provides an output file specification for the listing file.

  When in batch mode,  the  output  listing  is  created  by  default;
  however,  when in interactive mode, no output listing is produced by
  default.  The default file type for listing files is LIS.

  No wildcard characters are allowed in the file specification.

/OBJECT

 /OBJECT[=file-spec]
 /NOOBJECT

  Controls  whether  an  object  module  is  created  by  the  message
  compiler,  and  optionally provides an output file specification for
  the file.

  By default, the compiler creates an object module with the same file
  name  as the first input file and a file type of OBJ.  The output is
  directed to your default device and directory.

  The object module produced by default contains  text  with  symbols,
  but does not contain an indirect pointer to a compiled message file.
  See the /SYMBOLS, /TEXT, and /FILE_NAME qualifiers for ways to alter
  the contents of the object module.

  No wildcard characters are allowed in the file specification.

/SYMBOLS

 /SYMBOLS
 /NOSYMBOLS

  Controls whether global symbols will be present in the object module
  specified  by the /OBJECT qualifier.  By default, object modules are
  created  with  global  symbols.   You  may  specify  /NOSYMBOLS   to
  eliminate  global  symbols  from  the  object  module.  The /SYMBOLS
  qualifier requires that  /OBJECT  be  explicitly  or  implicitly  in
  effect.

/TEXT

 /TEXT
 /NOTEXT

  Controls whether the actual message text and associated  information
  are placed in the object module.  The default is /TEXT.  The /NOTEXT
  qualifier inhibits the creation of the data portion  of  the  object
  module.  The /TEXT and /FILE_NAME qualifiers are mutually exclusive.
  The  /TEXT  qualifier  requires  that  the  /OBJECT   qualifier   be
  explicitly  or  implicitly  in effect.  The /NOTEXT qualifier can be
  used in conjunction  with  /SYMBOLS  to  produce  an  object  module
  containing only global symbols.

Examples

  1.   $ MESSAGE/LIST=WEATHER2  WEATHER

  This MESSAGE command compiles the file WEATHER.MSG and  creates  the
  list  file WEATHER2.LIS.  The object module WEATHER.OBJ contains the
  message symbols and text.

  2.   $ MESSAGE/LIST=MSGOUTPUT/FILE_NAME=ALPHMESG  MESSAGEA

  This MESSAGE command compiles the file MESSAGEA.MSG and creates  the
  object  module  MESSAGEA.OBJ  with  no  text,  only  symbols  and an
  indirect pointer to the message file  ALPHMESG.   The  listing  file
  MSGOUTPUT.LIS  is  also  created.   At execution time, if no logical
  name   exists   for   ALPHMESG,   the   text    is    sought    from
  SYS$MESSAGE:ALPHMESG.EXE.

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026