Extracting Case Data (Extended)

If you want to specify the output format of the case data, use the following command:

swutil EXTCD [flags]procname[casenum[fields]]

where:

•

flags indicates one or more of the following optional parameters, preceded by a hyphen character (-), which can appear anywhere on the command line.

Parameter	Description
format	One of the following flags, which specifies the output format for the extracted data. (The default is -v if no format flag is included.) -v  verbose -a  abox -c  comma delimited -t  tab delimited -tchar  delimited by character char These formats are explained in Output Formats.
textmodifier	One of the following flags, which specifies whether the text is written with DOS or UNIX newline conventions. -u  UNIX: LF -d  DOS: CR + LF
-f	Causes a list of field names to be included as the first line of the output. It only applies if the -c, -t or -tchar format options are specified. The field names are written in upper-case letters, separated as specified by the format flag.

Examples of flag options:

-vu
-a -d
-dt~
-t

•

procname is the name of the procedure (case insensitive).

•

casenum is optional, and specifies the number of the case to be extracted, or one of the following may be used:

Value	Description
ALL_CASES	All cases for the procedure will be extracted.
ALL_ACTIVE	All active cases for the procedure.
ALL_TERM	All terminated cases for the procedure.

If this parameter is not specified, the default is ALL_CASES.

•

fields is optional (but requires that casenum is included), and provides a list of fields to be extracted, separated by commas, for example:

FIELD1,FIELD2,FIELD3 

(Field names are case insensitive.)

As well as fields defined in the procedure, the following predefined fields may be included:

Value	Description
SW_CASENUM	specifies the case number
SW_CASEREF	specifies the case reference, pp-nn
SW_CASEDESC	specifies the case description

Alternatively, ALL_FIELDS may be used to specify that all fields of the procedure should be extracted (including SW_CASENUM, and SW_CASEDESC if it is used as a marked field). This is the default if the parameter is omitted.