CQDEL(1)                 Network Queuing Env. 3.3     Last changed: 4-13-98


NNAAMMEE
     ccqqddeell - Deletes or signals batch requests from a Network Queuing
     Environment (NQE) client

SSYYNNOOPPSSIISS
     ccqqddeell [--dd _d_e_s_t__t_y_p_e] [--hh _t_a_r_g_e_t__h_o_s_t] [--PP]
     [--uu ddbbuusseerr = _d_b_u_s_e_r_n_a_m_e,_u_s_e_r_n_a_m_e] [--kk | --ss _s_i_g__n_a_m_e | --_s_i_g_n_o]
     _r_e_q_u_e_s_t_i_d_s | tt_i_d_s

IIMMPPLLEEMMEENNTTAATTIIOONN
     IRIX systems

     UNICOS/mk systems

     UNICOS systems

     AIX systems

     Digital UNIX systems

     HP-UX systems

     Solaris systems

DDEESSCCRRIIPPTTIIOONN
     The ccqqddeell utility issues a request to the NQE database or to the NQS
     server to delete or signal a specified request.  Running requests are
     not deleted unless you specify a signal.  A request residing in the
     NQE database can be deleted only by the database user (ddbbuusseerr) for
     that request or by the NQE administrator.

     A request at the NQS server can be deleted by its owner, another user
     with the proper validation, or an NQS manager or operator.  Only a
     user who has proper validation can delete a request at a remote host.
     For more information on user validation, see the NOTES section on the
     ccqqssuubb(1) man page.

     The ccqqddeell utility accepts the following options:

     --dd _d_e_s_t__t_y_p_e   Specifies the destination type for the request;
                    _d_e_s_t__t_y_p_e can be either nnqqeeddbb or nnqqss.  If _d_e_s_t__t_y_p_e is
                    nnqqeeddbb, the request is sent to the NQE database.  If
                    _d_e_s_t__t_y_p_e is nnqqss, the request is sent to your NQS
                    server, which is defined in the NNQQSS__SSEERRVVEERR environment
                    variable or in the nnqqeeiinnffoo file.  If you do not specify
                    a destination type, the value of NNQQEE__DDEESSTT__TTYYPPEE is used;
                    this value may exist in your environment or in the
                    nnqqeeiinnffoo file.  The command line option overrides an
                    environment or nnqqeeiinnffoo file variable setting.  The
                    default value of _d_e_s_t__t_y_p_e is nnqqss.  For more
                    information about the NNQQSS__SSEERRVVEERR and the NNQQEE__DDEESSTT__TTYYPPEE
                    environment variables, see the ENVIRONMENT VARIABLES
                    section.

     --hh _t_a_r_g_e_t__h_o_s_t Specifies the NQS server at which requests will be
                    deleted.  This option does not apply if you are sending
                    the ccqqddeell request to the NQE database.

     --PP             Prompts the user for a password.  The NQS server may
                    require a password.  If this is true, the --PP option
                    will ensure that you are prompted.  When you are
                    prompted for a password, enter the password that is
                    associated with the user name of the request.

     --uu _u_s_e_r_n_a_m_e
     --uu ddbbuusseerr=_d_b_u_s_e_r_n_a_m_e
     --uu ddbbuusseerr = _d_b_u_s_e_r_n_a_m_e,_u_s_e_r_n_a_m_e
                    The ddbbuusseerr argument is optional and defaults to the
                    client user name if not specified.  _d_b_u_s_e_r_n_a_m_e is the
                    name to be used to connect to the NQE database.  The
                    _u_s_e_r_n_a_m_e argument is optional and specifies the owner
                    of the request.  If you use the _d_b_u_s_e_r_n_a_m_e argument
                    with the _u_s_e_r_n_a_m_e argument, no space is allowed between
                    the comma and the _u_s_e_r_n_a_m_e argument.  The ddbbuusseerr
                    argument also may be set in the NNQQEEDDBB__UUSSEERR environment
                    variable.

                    For requests submitted to NQS, to delete requests that
                    were submitted to run as another user, you must use
                    this option.

                    For requests submitted to the NQE database, you may
                    delete only the requests that were submitted by the
                    same database user (ddbbuusseerr).

     --kk             Kills running requests by sending a SSIIGGKKIILLLL(09) signal
                    to _r_e_q_u_e_s_t_i_d_s or tt_i_d_s.

     --ss _s_i_g__n_a_m_e    Sends the signal specified by _s_i_g__n_a_m_e to _r_e_q_u_e_s_t_i_d_s or
                    tt_i_d_s that are running.  Different platforms might use
                    different signal numbers for a given signal.  If you
                    use the --ss option to specify a signal name, the same
                    signal is sent regardless of the platform on which the
                    request is running.  Values for _s_i_g__n_a_m_e can be any of
                    the following; the characters SSIIGG are optional:

                         [[SSIIGG]]AABBRRTT       [[SSIIGG]]FFPPEE
                         [[SSIIGG]]IILLLL         [[SSIIGG]]IINNTT
                         [[SSIIGG]]SSEEGGVV       [[SSIIGG]]TTEERRMM
                         [[SSIIGG]]AALLRRMM       [[SSIIGG]]CCHHLLDD
                         [[SSIIGG]]CCOONNTT       [[SSIIGG]]HHUUPP
                         [[SSIIGG]]KKIILLLL       [[SSIIGG]]PPIIPPEE
                         [[SSIIGG]]QQUUIITT       [[SSIIGG]]SSTTOOPP
                         [[SSIIGG]]TTSSTTPP       [[SSIIGG]]TTTTIINN
                         [[SSIIGG]]TTTTOOUU       [[SSIIGG]]UUSSRR11
                         [[SSIIGG]]UUSSRR22

     --_s_i_g_n_o         Sends signal _s_i_g_n_o to _r_e_q_u_e_s_t_i_d_s or tt_i_d_s that are
                    running.

     _r_e_q_u_e_s_t_i_d_s | tt_i_d_s
                    Specifies the request or requests that you want to
                    signal or delete.

                    _r_e_q_u_e_s_t_i_d specifies a request that is executing under
                    NQS.  Request identifiers have the following format:

                         _s_e_q_u_e_n_c_e__n_u_m_b_e_r [.._o_r_i_g__h_o_s_t] [@@_c_u_r_r__h_o_s_t]

                    The _s_e_q_u_e_n_c_e__n_u_m_b_e_r argument is the number assigned to
                    the request at the time of submission.  _o_r_i_g__h_o_s_t is
                    the original host of submission; if you omit it, NQS
                    uses the local NQS server.  _c_u_r_r__h_o_s_t is the NQS server
                    on which the request currently resides; if you omit it,
                    NQS uses the server you specified by using the --hh
                    option.  If you omit the --hh option, the host specified
                    by the NNQQSS__SSEERRVVEERR environment variable is used.

                    The tt_i_d_s operand specifies a request belonging to the
                    NQE database; tt identifies this as a user task, and _i_d
                    is a unique number assigned to the request at the time
                    it was inserted into the NQE database.

NNOOTTEESS
     If the UNICOS multilevel security (MLS) feature or the UNICOS/mk
     security enhancements are enabled on the NQS server and NQS is
     configured to enforce the mandatory access controls (MACs), your
     active label must equal the job submission label if your job is
     queued; if your job is executing, your active label must equal the job
     execution label.  If you specified the ccqqssuubb --LL or ccqqssuubb --CC utility
     when the job was submitted, the job execution label may not be the
     same as the job submission label.  To display the job submission and
     execution label information for a specific job, use the ccqqssttaattll --ff
     _r_e_q_u_e_s_t_i_d utility.  NQS managers and operators bypass the MAC checks.

     If the UNICOS MLS feature or the UNICOS/mk security enhancements are
     enabled on the NQS server, you cannot delete a request at a remote
     host if the execution host has a workstation access list (WAL) entry
     for the host of origin that restricts your access to NQS services.

     The --uu option may not be valid on UNICOS MLS or UNICOS/mk security-
     enhanced systems.  When MLS or security enhancements are enabled, the
     system might be configured to require the //eettcc//hhoossttss..eeqquuiivv and ..rrhhoossttss
     files to each contain a match for the remote host and require that the
     remote user and local user names match (that is, the --uu option is not
     allowed).

EENNVVIIRROONNMMEENNTT VVAARRIIAABBLLEESS
     The NNQQSS__SSEERRVVEERR environment variable specifies the NQS server with
     which you want to communicate.  You must specify the TCP/IP name of
     the host running the NQS server; optionally you can specify a TCP/IP
     port number.  You must precede the port number by a colon.  The
     following is the C shell syntax:

          setenv NQS_SERVER _s_e_r_v_e_r [::_p_o_r_t]

     The standard shell and Korn shell syntax follows:

          NQS_SERVER=_s_e_r_v_e_r  [::_p_o_r_t]
          eexxppoorrtt NNQQSS__SSEERRVVEERR

     The NNQQSS__PPAASSSSWWOORRDD__NNEEEEDDEEDD environment variable, if defined, specifies
     that users are prompted for a password for all NQE client commands.

     The NNQQEE__DDEESSTT__TTYYPPEE environment variable, if defined, specifies the
     destination of your request, which can be the NQS server (nnqqss) or the
     NQE database (nnqqeeddbb).  The following is the C shell syntax:

          setenv NQE_DEST_TYPE _v_a_l_u_e

     The NNQQEEDDBB__UUSSEERR environment variable, if defined, specifies the name to
     be used to connect to the NQE database.  The following is the C shell
     syntax:

          setenv NQEDB_USER _d_b_u_s_e_r_n_a_m_e

     The MMSSQQLL__SSEERRVVEERR and MMSSQQLL__TTCC--PPOORRTT environment variables, if defined,
     specify an NQE database server and its port number instead of using
     the default (MSQL is the NQE database).  The following is the C shell
     syntax:

          setenv MSQL_SERVER _s_e_r_v_e_r__n_a_m_e
          sseetteennvv MMSSQQLL__TTCCPP__PPOORRTT _p_o_r_t__n_u_m_b_e_r

EEXXIITT SSTTAATTUUSS
     An exit status of 0 indicates success.  A nonzero exit status
     indicates an error.

MMEESSSSAAGGEESS
     The standard error file (ssttddeerrrr) lists explanatory messages for all
     irregularities.

EEXXAAMMPPLLEESS
     Example 1:  The following line deletes the queued request 11223344 at the
     host specified by the NNQQSS__SSEERRVVEERR environment variable:

          $ cqdel 1234

     Example 2:  The following line deletes request tt88 from the NQE
     database (NNQQEE__DDEESSTT__TTYYPPEE is nnqqeeddbb); the user name sending the request
     is the same as the database user (ddbbuusseerr) who submitted the request:

          $ cqdel t8

     Example 3:  The following line deletes request tt112233 from the NQE
     database when NNQQEE__DDEESSTT__TTYYPPEE is nnqqss; the user name sending the request
     is the same as the database user (ddbbuusseerr) who submitted the request:

          $ cqdel -d nqedb t123

     Example 4:  The following line sends a SSIIGGKKIILLLL signal to the running
     request 110011..aabbcc at host ddeeff:

          $ cqdel -k 101.abc@def

     Example 5:  An alternative form of the previous example follows:

          $ cqdel -h def -09 101.abc

     Example 6:  From host aabbcc, the following line deletes requests
     110022..aabbcc, 110033..aabbcc, and 220011..ddeeff at host ddeeff:

          $ cqdel -h def -k 102 103 201.def

     Example 7:  The following line sends signal SSIIGGUUSSRR11 (16) to request
     110044, owned by user aallttuussrr, at the local host:

          $ cqdel -s USR1 -u altusr 104

     Example 8:  The following line deletes running request 110055..aabbcc at the
     local host ddeeff:

          $ cqdel -k 105.abc

SSEEEE AALLSSOO
     ccqqssttaattll(1), ccqqssuubb(1), nnqqee(1) for information about batch requests
     submitted from an NQE client
     qqddeell(1), qqssttaatt(1), qqssuubb(1) for information about batch requests
     submitted locally
     qqlliimmiitt(1) for information about queue limits enforced on your NQS
     server

     kkiillll(2), ssiiggnnaall(2) for information about system calls that signal
     processes in the

     nnqqeeiinnffoo(5) for information on the nnqqeeiinnffoo file

     _U_N_I_C_O_S _S_y_s_t_e_m _C_a_l_l_s _R_e_f_e_r_e_n_c_e _M_a_n_u_a_l, publication SR-2012

     _N_Q_E _U_s_e_r'_s _G_u_i_d_e, publication SG-2148, for NQE and NQS user
     information

     _N_Q_E _A_d_m_i_n_i_s_t_r_a_t_i_o_n, publication SG-2150, for NQE and NQS
     administration information

     This man page is available only online.