STATUS Subcommand (SURVREG AFT command)
STATUS is an optional subcommand to define status. If omitted, failure/event
will be the default status for all cases if one dependent variables are specified and interval
censoring if two dependent variables are specified.
- 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/LEFT/INTERVAL
- The settings are determined by the variable specified by /VARIABLE. If the variable specified is
a string, all the values specified for these parameters are case sensitive and must be within a pair
of single quotes, and the keyword THRU is not allowed. If the variable specified is numeric, all the
values 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 specified after it must be greater than
the one specified before. Duplicated values within each parameter, if any, will be ignored
regardless of strings or numeric ones. Inconsistent assignments across the parameters, if any, are
not allowed. That is, one parameter cannot take any values same as the one assigned by any other
parameter. NULL is supported for both string and numeric status, which indicates that no records
will be assigned to the associated mapping category. It is not allowed that NULL is specified for
FAILURE, RIGHT, LEFT, and INTERVAL, and UNMAPPED=EXCLUDE. 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 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 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.
- LEFT
- An optional parameter to map a record to left censoring. If the status variable is a string, the default value is 'L.' 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 NULL. Multiple numeric values separated by a comma, a blank space, or blank spaces are allowed. Alternatively, multiple THRU keywords 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.
- INTERVAL
- An optional parameter to map a record to denote interval censoring. If the status variable is a string, the default value is 'I.' 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 NULL. Multiple numeric values separated by a comma, a blank space, or blank spaces are allowed. Alternatively, multiple THRU keywords 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. The process will be ignored if a single dependent variable is specified after SURVREG AFT.
- UNMAPPED
- An optional parameter to control those unmapped records. The default is F, which maps them to the failure/event category. R, L, and I will map them to right, left, and interval censoring, respectively. I is not available if a single dependent variable is specified after SURVREG AFT. EXCLUDE will delete the records which fail to be mapped. Note that even if NULL is specified for FAILURE, RIGHT, LEFT, and/or INTERVAL, UNMAPPED could still map those unmapped records to any of them in an effective way.