11.6 x/zvpopen—Open a parameter data set for output. NOT RECOMMENDED

call xvpopen( status, npar, max_len, filenam,error_act, unit ) 
status = zvpopen( npar, max_len, filenam, error_act,unit ) 

x/zvpopen opens a new parameter data set for output. The file created is a labeled VICAR file of type PARM, with fixed length 512 byte records.
x/zvpopen uses x/zvopen to open the file. The file unit number is maintained internally for reference by x/zvpout and x/zvpclose. Only one parameter data set may be opened for writing at a time.

Arguments:

• STATUS: output, integer
  VICAR return status. Possible values are listed in Appendix B: Error Messages (page 140).
• NPAR: input, integer
  this parameter is ignored, and is kept only to maintain compatibility with old programs.
• MAX_LEN: input, integer
  this parameter is ignored, and is kept only to maintain compatibility with old programs.
• FILENAM: input, string
  The name of the parameter file to be opened.
• ERROR_ACT: input, string
  The action to be taken if an error occurs either in the opening of the file or in a subsequent call to x/zvpout or x/zvpclose. The string is a combination of any of three letters: A, S, and U. The appearance of one of these letters in the string causes the following action to take place in the event of an error:
  • A: Abort the program
  • S: Issue a system error message
  • U: Issue a user message

If ERROR_ACT is not given, the error action will default to the action specified by x/zveaction.

• UNIT: output, integer
  If given, UNIT will contain the VICAR I/O unit number being used for the parameter data set. It may then be used in conjunction with other VICAR I/O routines for operations such as adding label information ( x/zladd).
  Non-label I/O (i.e., x/zvread or x/zvwrit) should not be performed on a parameter data set, as it is possible to destroy the data contained in it.