STATUS Subcommand (SURVREG RECURRENT command)
STATUS is an optional subcommand to define status. If omitted, failure/event
becomes the default status for all cases.
- VARIABLE
- If /STATUS is specified, it is a required parameter to specify the status variable. If specified, only a single variable is allowed, and it cannot be the same as the dependent variable(s).
- FAILURE/RIGHT
-
The settings are determined by the variable that is specified by /VARIABLE. If the variable that is specified is a string, all the values that are specified for these parameters are case-sensitive and must be within a pair of single quotation marks, and the keyword THRU is not allowed. If the variable specified is numeric, all the values that are specified for these parameters must be numeric, and the keyword THRU is allowed. If THRU is specified, it must connect two single values, and the value that is specified after it must be greater than the one specified before. Duplicate values within each parameter, if any, are ignored regardless of whether they are string or numeric. Inconsistent assignments across the parameters, if any, are not allowed. That is, one parameter cannot take any values same as the one assigned by the other. NULL is supported for both string and numeric status, which indicates that no records will be assigned to the associated mapping category. When NULL is specified for FAILURE and RIGHT, UNMAPPED=EXCLUDE is not allowed. The details are as follows:
- FAILURE
- An optional parameter to map a record to denote failure/event. If the status variable is a string, the default value is 'F.' Multiple string values separated by a comma. a blank space, or blank spaces are allowed. If the status variable is numeric, the default value is 1. Multiple numeric values separated by a comma, a blank space, or blank spaces are allowed. Alternatively, multiple THRU keywords that are separated by a comma, a blank space, or blank spaces are allowed to specify the ranges. A mixture of single value(s) and THRU keyword(s) is allowed.
- RIGHT
- An optional parameter to map a record to denote right censoring. If the status variable is a string, the default value is 'R.' Multiple string values separated by a comma, a blank space, or blank spaces are allowed. If the status variable is numeric, the default value is 0. Multiple numeric values separated by a comma, a blank space, or blank spaces are allowed. Alternatively, multiple THRU keywords that are separated by a comma, a blank space, or blank spaces are allowed to specify the ranges. A mixture of single value(s) and THRU keyword(s) is allowed.
- UNMAPPED
- An optional parameter to control those unmapped records. The default is F, which maps them to the failure/event category. R maps them to right censoring. EXCLUDE deletes the records, which fail to get mapped. Note that even if NULL is specified for FAILURE and/or RIGHT, UNMAPPED might still map those unmapped records to any of them in an effective way.