UNTIL Keyword—Expire Date

Valid on z/OS, z/VSE, and z/VM.

Use the UNTIL keyword to assign or remove the specific date:

On which an ACID expires.
When permission to access a resource expires.

The format for date entries is determined by the settings for the DATE control option. The default is mm/dd/yy.

Any year (yy) entered as 70 or above is considered a 20th century date. Any year below 70 is considered a 21st century date. For example, 68 would be processed as being 2068 not 1968.

If the expiration date for the profile has already passed, UNTIL is displayed as “EXPIRED”.

This keyword has the following format:

TSS ADDTO(acid) UNTIL(mm/dd/yy)

TSS PERMIT(acid) resource(prefix(es))
                 UNTIL(mm/dd/yy)

This keyword is used with:

The commands ADDTO, CREATE, PERMIT, REMOVE, REPLACE, and REVOKE
The ACID types User, DCA, VCA, ZCA, LSCA, SCA, and MSCA
No specific authority

Examples: UNTIL keyword

The following examples assume the date format is mm/dd/yy.

This example allows use of an ACID until December of 1997:

TSS ADDTO(YURGO) UNTIL(12/01/97)

This example changes YURGO's expiration date from 12/01/97 to 07/04/98.

TSS ADDTO(YURGO) UNTIL(07/04/98)

The same change could have been made with the REPLACE function. This example removes the expiration dates:

TSS REMOVE(YURGO) UNTIL

This example removes the expiration interval when you are unsure of whether you specified FOR or UNTIL on the TSS ADDTO:

TSS REMOVE(acid) EXPIRE

This example reactivates an expired ACID:

TSS ADDTO(ACID56) UNTIL(mm/dd/yy)

This example reactivates an expired ACID:

TSS ADDTO(USER56) FOR(0)

This example uses the UNTIL keyword in conjunction with the FACILITY and PROFILE keywords:

TSS ADDTO(USER56) FACILITY(CICSPROD)
                  UNTIL(07/04/97)

This example specifying the UNTIL keyword with PROFILE, lets you see the expiration date(s):

TSS LIST(profacid) DATA(EXP)

The UNTIL keyword cannot be used to REMOVE an expiration date from a facility or profile.

This example will not remove the expiration date from the profile, but will remove the profile from the user record:

TSS REMOVE(USER56) PROFILE(TECHPROF)
                   UNTIL

To remove an expiration date from a facility or profile, the facility or profile must be removed from the ACID and then added again to the ACID without the expiration date.

This example permits USER01 to READ (default) to any data set suffixed by .FILE until May 1, 2001 (11:59:59 pm on April 30, 2001):

TSS PERMIT(USER01) DSNAME(****.FILE)
                   UNTIL(05/01/01)