[next] [previous] [contents]

  CVTPAR

  Converts the DCL P1 - P8 parameters (or any other set of
  symbols) into a single symbol.

  Format
  CVTPAR symbol-name

  Parameters
  symbol-name

  Specifies the name of the symbol to receive the resultant
  converted parameters.
  The final length of this resultant symbol must be less than or
  equal to 255 characters.

  If an error occurs during processing, no attempt is made to
  set the symbol's value. Thus, if the symbol already exists,
  its value is not be changed, and if it doesn't exist, it remains
  undefined.

  Qualifiers
  /DEPTH=depth

  Specifies the depth of substitution that the resultant sym-
  bol will undergo. The effect is to multiply the number of
  double quotes that are placed around sensitive parts of the
  parameters. For each level of depth, each sensitive part of
  a parameter is surrounded by two to the power of the depth
  number of double quotes.

  For example /DEPTH=3 would cause each sensitive part of a
  parameter to be surrounded by eight double quotes.

  By default, /DEPTH=1 is assumed.

  /GLOBAL

  Specifies that the symbol be placed in the global symbol ta-
  ble. If you do not specify the /GLOBAL qualifier, the symbol is
  placed in the local symbol table.

  /LOCAL (Default)
  Specifies that the symbol be placed in the local symbol table
  for the current command procedure.

  /PARAMETERS[=(sym-nam[,...])]
  Specifies the actual symbols to be used as parameters. By de-
  fault, /PARAMETERS=(P1,P2,P3,P4,P5,P6,P7,P8) is assumed.

  Examples
  1.
{system-prompt}
        {user-response}