QDEL(1) Network Queuing Env. 3.3 Last changed: 4-13-98 NNAAMMEE qqddeell - Deletes or signals NQS requests SSYYNNOOPPSSIISS qqddeell [--hh _t_a_r_g_e_t__h_o_s_t] [--uu _u_s_e_r_n_a_m_e] [{--ff | --kk | --ss _s_i_g__n_a_m_e | --_s_i_g_n_o}] _r_e_q_u_e_s_t_i_d_s IIMMPPLLEEMMEENNTTAATTIIOONN IRIX systems UNICOS/mk systems UNICOS systems AIX systems Digital UNIX systems HP-UX systems Solaris systems DDEESSCCRRIIPPTTIIOONN The qqddeell utility deletes or sends a signal to specified Network Queuing System (NQS) requests. Running requests are not deleted unless you specify a signal. If you do not specify a target host, the local host is used as the target host at which requests will be deleted. You can signal up to 100 requests with one qqddeell utility. A request at the local host can be deleted by its owner, another user with the proper validation, or an NQS administrator. 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 qqssuubb(1) man page. If the UNICOS multilevel security (MLS) feature or the UNICOS/mk security enhancements are enabled on your NQS server and NQS is configured to enforce the mandatory access controls (MAC), 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 qqssuubb --LL or qqssuubb --CC command when the job was submitted, the job execution label might not be the same as the job submission label. To display the job submission and execution label information for a specific job, use the qqssttaatt --ff command. NQS managers and operators bypass the MAC checks. The qqddeell utility accepts the following options: --hh _t_a_r_g_e_t__h_o_s_t Specifies the default NQS host at which requests will be deleted. If the UNICOS MLS feature or the UNICOS/mk security enhancements are enabled on your NQS server, you cannot delete a request at that host if the host has a workstation access list (WAL) entry for the host of origin that restricts your access to NQS services. --uu _u_s_e_r_n_a_m_e Specifies the owner of _r_e_q_u_e_s_t_i_d_s. You must use this option to delete requests that other users own. This option might not be valid on UNICOS MLS or UNICOS/mk security-enhanced systems. When the UNICOS MLS feature or the UNICOS/mk 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). --ff Kills running requests by sending a SSIIGGKKIILLLL(09) signal to _r_e_q_u_e_s_t_i_d_s that are running. The job output is also deleted. --kk Kills running requests by sending a SSIIGGKKIILLLL(09) signal to _r_e_q_u_e_s_t_i_d_s that are running. The job output is returned. --ss _s_i_g__n_a_m_e Sends the signal specified by _s_i_g__n_a_m_e to requests 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 the specified signal number _s_i_g_n_o to _r_e_q_u_e_s_t_i_d_s that are running. _r_e_q_u_e_s_t_i_d_s Specifies the request or requests you want to signal or delete. The 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 host on which the request currently resides; if you omit it, NQS uses the host specified by the --hh option, or, if you omit the --hh option, NQS uses the local NQS server. EEXXIITT SSTTAATTUUSS An exit status of 0 indicates normal completion. An exit status of 1 indicates a user error. An exit status of 2 indicates an NQS 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 local host: qdel 1234 Example 2. The following line sends a SSIIGGKKIILLLL signal to the running request 110011..aabbcc at host ddeeff: qdel -k 101.abc@def Example 3. An alternative form of the previous example follows: qdel -h def -09 101.abc Example 4. From host aabbcc, the following line deletes requests 110022..aabbcc, 110033..aabbcc, and 220011..ddeeff at host ddeeff: qdel -h def -k 102 103 201.def Example 5. The following line sends signal SSIIGGUUSSRR11 (16) to request 110044, owned by user ssoommeeuussrr, at the local host: qdel -s USR1 -u someusr 104 Example 6. The following line deletes running request 110055..aabbcc at the local host: qdel -k 105.abc Example 7. The following line deletes running request 110066 at the local host and does not return its output: qdel -f 106 SSEEEE AALLSSOO ccqqddeell(1), ccqqssttaattll(1), ccqqssuubb(1), nnqqee(1) for information about batch requests submitted from an NQC qqcchhkkppnntt(1), qqlliimmiitt(1), qqmmssgg(1), qqssttaatt(1), qqssuubb(1) for information on batch request submission from a local NQS system kkiillll(2), ssiiggnnaall(2) for information about system calls that signal processes in the _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 iiaa__ffaaiilluurree(3C), iiaa__ssuucccceessss(3C), iiaa__uusseerr(3C) for information about the UNICOS and UNICOS/mk identification and authentication feature in the _U_N_I_C_O_S _S_y_s_t_e_m _L_i_b_r_a_r_i_e_s _R_e_f_e_r_e_n_c_e _M_a_n_u_a_l, publication SR-2080 and the _U_N_I_C_O_S/_m_k _S_y_s_t_e_m _L_i_b_r_a_r_i_e_s _R_e_f_e_r_e_n_c_e _M_a_n_u_a_l, publication SR-2680 nnqqeeiinnffoo(5) for information on the nnqqeeiinnffoo file _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.