VMS Help  —  FMS  /LIBRARY
  The  FMS/LIBRARY  command  performs operations on form files and form
  libraries.  The  FMS/LIBRARY  command  has  subcommands.  The default
  subcommand  is  FMS/LIBRARY/REPLACE, which is used to add forms to an
  existing library.

1    /CREATE 

  The   FMS/LIBRARY/CREATE   command  creates  a  new  library  from  a
  collection  of  form  specifications.  The default input file type is
  FRM, and the default output file type is FLB.

  Example:

    FMS/LIBRARY/CREATE NEWLIB LIB1/FORM_NAME=FORM1,FORM2,LIB2.FLB

      A form library  NEWLIB.FLB  is  created from the form FORM1 found
      in the existing library LIB1, the individual form file FORM2, and
      the  entire  contents of LIB2. If forms names are duplicated, the
      first form named is included in the library.

1.1  –  Qualifiers

1.1.1    /FORM_NAME 

  library_spec/FORM_NAME=(form_name,...)

  Extract  from  the  input  library  those  forms  specified after the
  /FORM_NAME qualifier.  The qualifier applies only to the  immediately
  preceding form library.  If the /FORM_NAME qualifier  is omitted, the
  entire library is used.

  To name more than one form, enclose the list in parentheses.

1.1.2    /LOG 

  /LOG
  /NOLOG (D)

  Produces  a  log on the device SYS$OUTPUT showing the forms input  to
  the new library - especially useful if an entire existing  library is
  input.  The /NOLOG qualifier disables logging.

2    /DELETE 

  The  FMS/LIBRARY/DELETE  command  removes  the  specified form from a
  form  library. Use the /FORM_NAME qualifier to specify the form to be
  deleted.  The default input file type is FLB. There is no output. (To
  delete the entire library use the the DCL DELETE verb.)

  Example:

      FMS/LIBRARY/DELETE LIBNAME/FORM_NAME=(FORM1,FORM2,FORM3)/LOG

      The  forms  FORM1,  FORM2  and  FORM3  are  deleted  from  the
      library  LIBNAME  and  a  log  of  the  operation is output to
      the device SYS$OUTPUT.

2.1  –  Qualifiers

2.1.1    /FORM_NAME 

  library_spec/FORM_NAME=(form_name,...)

  Specifies  a  form  to be deleted from the library.  To specify  more
  than one form enclose  the  list  in parentheses.  This  qualifier is
  required for the FMS/LIBRARY/DELETE command.

2.1.2    /LOG 

  /LOG
  /NOLOG (D)

  Produces  a  log  of  forms  deleted on the device  SYS$OUTPUT.   The
  /NOLOG qualifier disables logging.

3    /EXTRACT 

  The  FMS/LIBRARY/EXTRACT  command extracts the specified form from  a
  form library. Use the /FORM_NAME qualifier to specify the form  to be
  extracted.  The form file will have the same name as the  form unless
  the /OUTPUT qualifier is used to change the name.  Default file types
  are FLB for the library and FRM for the output  form.   Only one form
  can be extracted at a time.

  Example:

      FMS/LIBRARY/EXTRACT LIBNAME/FORM_NAME=AFORM/OUTPUT=THATFORM

      The  form  AFORM  is  extracted from the form library
      LIBNAME.FLB and placed in the form file THATFORM.FRM.

3.1  –  Qualifiers

3.1.1    /FORM_NAME 

  library_spec/FORM_NAME=form_name

  Specifies a form to be extracted.   Only one form may be extracted at
  a time.

3.1.2    /LOG 

  /LOG
  /NOLOG (D)

  Produces  a log on the device SYS$OUTPUT showing the form  extracted.
  The /NOLOG qualifier disables logging.

3.1.3    /OUTPUT 

  /OUTPUT=file_spec (D)
  /NOOUTPUT

  The  /OUTPUT  qualifier  allows  you to specify a name for the output
  form file. If the file specification is omitted, the output file name
  is  the  same as the form name, with the file type FRM. The /NOOUTPUT
  qualifier can be used to discard output.

4    /INSERT 

  The  FMS/LIBRARY/INSERT  command  places  the  specified  form in the
  output form library. Input forms do not replace forms that  have  the
  same  name in the form library. If any of the input files contain the
  same name,  the  first form specified is inserted in the library. The
  default input file  type is FRM,  and the default output file type is
  FLB.

4.1  –  Qualifiers

4.1.1    /FORM_NAME 

  library_spec/FORM_NAME=(form_name,...)

  Extract  from  the  input  library  those  forms  specified after the
  /FORM_NAME qualifier.  The qualifier applies only to the  immediately
  preceding form library.  If the /FORM_NAME qualifier  is omitted, the
  entire library is used.

  To name more than one form, enclose the list in parentheses.

4.1.2    /LOG 

  /LOG
  /NOLOG (D)

  Produces  a log on the device SYS$OUTPUT showing the forms  copied to
  the output library - especially useful if an entire  existing library
  is input.  The /NOLOG qualifier disables logging.

5    /REPLACE (D) 

  The  FMS/LIBRARY/REPLACE  command  places  the  specified  form in an
  output  form  library.  Input  forms replace forms that have the same
  name  in the form library. If any of the input files contain the same
  name,   the  last  form  specified  is  inserted  in the library. The
  default  input  file  type is FRM and the default output file type is
  FLB.

5.1  –  Qualifiers

5.1.1    /FORM_NAME 

  library_spec/FORM_NAME=(form_name,...)

  Extract  from  the  input  library  those  forms  specified after the
  /FORM_NAME qualifier.  The qualifier applies only to the  immediately
  preceding form library. If the  /FORM_NAME qualifier  is omitted, the
  entire library is used.

  To name more than one form, enclose the list in parentheses.

5.1.2    /LOG 

  /LOG
  /NOLOG (D)

  Produces  a log on the device SYS$OUTPUT showing the forms  copied to
  the output library - especially useful if an entire  existing library
  is input.  The /NOLOG qualifier disables logging.
Close Help