crls



NAME

      crls - list CRs


SYNOPSIS

      crls [-uuser | -wuser] [-sstate] [-rsymbolic_name] [-ddate]  [-ffile]
      [-T[SVANDC]] [-x] [-A] [CR ...]


DESCRIPTION

      List CRs. Different formats of the list may be produced. By default,
      the format which shows the CR name and CR title is used. The option -T
      is used to define the output format. Other options are used for
      selecting of CRs or CR versions. If no CR is specified, then all CRs
      are listed that match specified options.

    PARAMETERS
      CR ...
           Names of Change Requests, the specification can include
           wildcards, for example *cr*.

    OPTIONS
      -u[user]
           Lists the latest file versions that the user is owner of. If the
           user is omitted, the current user is taken.

      -w[user]
           Lists the file versions the user is owner of. If the user is
           omitted, the current user is taken.

      -sstate
           Lists CRs with the status state. The default value for the state
           is Exp.

      -rsymbolic_name
           Lists CRs with the name symbolic_name.

      -ddate
           Print information about CRs which versions have a checkin
           date/time in the ranges given by the semicolon-separated list of
           dates. A range of the form d1<d2 or d2>d1 selects the versions
           that were deposited between d1 and d2 inclusive. A range of the
           form <d or d> selects all versions dated d or earlier. A range of
           the form d< or >d selects all versions dated d or later. A range
           of the form d selects the single, latest version dated d or
           earlier. The date/time strings d, d1, and d2 are in the free
           format explained in co(1). Quoting is normally necessary,
           especially for < and >. Note that the separator is a semicolon.

      -ffile
           Lists CRs that include File: file specification.


      -T[SVANDC]
           Define the output format. The following keys are defined:
           S  List CR State
           V  List CR Version Number
           A  List CR Responsible
           N  List CR Symbolic name (if defined)
           D  List CR Version Date
           C  List CR Title

           Any combination of these keys may be used. If only -T is
           specified (without key), only the CR name is listed.

      -x   If the argument list is too long, and errors are got from the
           shell, use -x option to list the CRs.

      -A   The CRs in all systems should be printed. The CRs in the current
           system are printed first. The option -A can be specified, or the
           environment variable SDE_CRSEARCH can be set to ALL. The
           environment variable SDE_CRSEARCH_FILE points to a file with all
           systems listed. The syntax of SDE_CRSEARCH_FILE is (showed with
           example):
           SDE_SYSTEM=sde_system SDE_SYSCONF=2.2-0


EXTERNAL INFLUENCES

      The CR directory is placed in $SDE_SYSTEM/master/.../$SDE_SYSCONF/cr.
      The environment variable SDE_CRSEARCH can be set to ALL, to search all
      systems.
      The SDE_CRSEARCH_FILE environment variable points to a file with all
      systems/configurations included.


EXAMPLES

      crls -s -w #show all my CRs with the state Exp
      crls *tele* #show all CRs that include the string tele in the name



SEE ALSO

      cr(1) cradd(1) craddf(1) craddt(1) crassign(1) crcat(1) crcheck(1)
      crcre(1) crdel(1) cred(1) credt(1) crlf(1) crmove(1) crremf(1)
      crren(1) crstate(1) crsymname(1) crterminate(1)


AUTHOR

      Ivica Crnkovic, Elisabet de Waal