114 lines
6.5 KiB
HTML
114 lines
6.5 KiB
HTML
|
<?xml version="1.0" encoding="UTF-8"?>
|
||
|
|
<!DOCTYPE html
|
||
|
|
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
||
|
|
<html lang="en-us" xml:lang="en-us">
|
||
|
|
<head>
|
||
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
||
|
|
<meta name="security" content="public" />
|
||
|
|
<meta name="Robots" content="index,follow" />
|
||
|
|
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
|
||
|
|
<meta name="DC.Type" content="reference" />
|
||
|
|
<meta name="DC.Title" content="Jobs" />
|
||
|
|
<meta name="abstract" content="" />
|
||
|
|
<meta name="description" content="" />
|
||
|
|
<meta name="copyright" content="(C) Copyright IBM Corporation 2006" />
|
||
|
|
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 2006" />
|
||
|
|
<meta name="DC.Format" content="XHTML" />
|
||
|
|
<meta name="DC.Identifier" content="vjob" />
|
||
|
|
<meta name="DC.Language" content="en-us" />
|
||
|
|
<!-- All rights reserved. Licensed Materials Property of IBM -->
|
||
|
|
<!-- US Government Users Restricted Rights -->
|
||
|
|
<!-- Use, duplication or disclosure restricted by -->
|
||
|
|
<!-- GSA ADP Schedule Contract with IBM Corp. -->
|
||
|
|
<link rel="stylesheet" type="text/css" href="./ibmdita.css" />
|
||
|
|
<link rel="stylesheet" type="text/css" href="./ic.css" />
|
||
|
|
<title>Jobs</title>
|
||
|
|
</head>
|
||
|
|
<body id="vjob"><a name="vjob"><!-- --></a>
|
||
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
||
|
|
<h1 class="topictitle1">Jobs</h1>
|
||
|
|
<div><p></p>
|
||
|
|
<div class="section"><p>The jobs vaccess (GUI) components allow a Java™ program
|
||
|
|
to present lists of server jobs and job log messages in a GUI.</p>
|
||
|
|
</div>
|
||
|
|
<div class="section"><p>The following components are available:</p>
|
||
|
|
</div>
|
||
|
|
<div class="section"><ul><li>A <a href="javadoc/com/ibm/as400/vaccess/VJobList.html#NAVBAR_TOP"> VJobList</a> object is a resource that represents a list
|
||
|
|
of server jobs for use in <a href="vpanes.htm#vpanes"> AS400Panes</a>.</li>
|
||
|
|
<li>A <a href="javadoc/com/ibm/as400/vaccess/VJob.html#NAVBAR_TOP"> VJob</a> object is a resource that represents the list
|
||
|
|
of messages in a job log for use in AS400Panes.</li>
|
||
|
|
</ul>
|
||
|
|
</div>
|
||
|
|
<div class="section"><p>You can use AS400Panes, VJobList objects, and VJob objects together
|
||
|
|
to present many views of a job list or job log.</p>
|
||
|
|
</div>
|
||
|
|
<div class="section"><p>To use a VJobList, set the system, name, number, and user properties.
|
||
|
|
Set these properties by using a constructor or through the <a href="javadoc/com/ibm/as400/vaccess/VJobList.html#SETSYSTEM(COM.IBM.AS400.ACCESS.AS400)"> setSystem()</a>, <a href="javadoc/com/ibm/as400/vaccess/VJobList.html#SETNAME(JAVA.LANG.STRING)"> setName()</a>, <a href="javadoc/com/ibm/as400/vaccess/VJobList.html#SETNUMBER(JAVA.LANG.STRING)"> setNumber()</a>, and <a href="javadoc/com/ibm/as400/vaccess/VJobList.html#SETUSER(JAVA.LANG.STRING)"> setUser()</a> properties.</p>
|
||
|
|
</div>
|
||
|
|
<div class="section"><p>To use a VJob, set the system property. Set this property by using
|
||
|
|
a constructor or through the <a href="javadoc/com/ibm/as400/vaccess/VJob.html#SETSYSTEM(COM.IBM.AS400.ACCESS.AS400)"> setSystem()</a> method.</p>
|
||
|
|
</div>
|
||
|
|
<div class="section"><p>Either the VJobList or VJob object is then "plugged" into the
|
||
|
|
AS400Pane as the root, using the pane's constructor or setRoot() method.</p>
|
||
|
|
</div>
|
||
|
|
<div class="section"><p>VJobList has some other useful properties for defining the set
|
||
|
|
of jobs that are presented in AS400Panes. Use <a href="javadoc/com/ibm/as400/vaccess/VJobList.html#SETNAME(JAVA.LANG.STRING)"> setName()</a> to specify that only jobs with a certain name
|
||
|
|
appear. Use <a href="javadoc/com/ibm/as400/vaccess/VJobList.html#SETNUMBER(JAVA.LANG.STRING)"> setNumber()</a> to specify that only jobs with a certain
|
||
|
|
number appear. Similarly, use <a href="javadoc/com/ibm/as400/vaccess/VJobList.html#SETUSER(JAVA.LANG.STRING)"> setUser()</a> to specify that only jobs for a certain user
|
||
|
|
appear.</p>
|
||
|
|
</div>
|
||
|
|
<div class="section"><p>When AS400Pane, VJobList, and VJob objects are created, they are
|
||
|
|
initialized to a default state. The list of jobs or job log messages are
|
||
|
|
not loaded at creation time. To load the contents, the caller must explicitly
|
||
|
|
call the load() method on either object. This will initiate communication
|
||
|
|
to the server to gather the contents of the list.</p>
|
||
|
|
</div>
|
||
|
|
<div class="section"><p>At run-time, right-click a job, job list, or job log message to
|
||
|
|
display the shortcut menu. Select <strong>Properties</strong> from the shortcut menu
|
||
|
|
to perform actions on the selected object:</p>
|
||
|
|
</div>
|
||
|
|
<div class="section"><ul><li>Job - Work with properties, such as the type and status. You can also
|
||
|
|
change the value of some of the properties.</li>
|
||
|
|
<li>Job list - Work with the properties, such as name, number, and user properties.
|
||
|
|
You can also change the contents of the list.</li>
|
||
|
|
<li>Job log message - Display properties, such as the full text, severity,
|
||
|
|
and time sent.</li>
|
||
|
|
</ul>
|
||
|
|
</div>
|
||
|
|
<div class="section"><p>Users can only access jobs to which they are authorized. In addition,
|
||
|
|
the Java program
|
||
|
|
can prevent the user from performing actions by using the setAllowActions()
|
||
|
|
method on the pane.</p>
|
||
|
|
</div>
|
||
|
|
<div class="section"><p><span class="synph" id="vjob__vjobex1"><a name="vjob__vjobex1"><!-- --></a><span class="kwd"></span></span>The following example creates
|
||
|
|
a VJobList and presents it in an AS400ExplorerPane:</p>
|
||
|
|
</div>
|
||
|
|
<div class="section"><div class="p"><pre> // Create the VJobList object. Assume
|
||
|
|
// that "system" is an AS400 object
|
||
|
|
// created and initialized elsewhere.
|
||
|
|
VJobList root = new VJobList (system);
|
||
|
|
|
||
|
|
// Create and load an
|
||
|
|
// AS400ExplorerPane object.
|
||
|
|
AS400ExplorerPane explorerPane = new AS400ExplorerPane (root);
|
||
|
|
explorerPane.load ();
|
||
|
|
|
||
|
|
// Add the explorer pane to a frame.
|
||
|
|
// Assume that "frame" is a JFrame
|
||
|
|
// created elsewhere.
|
||
|
|
frame.getContentPane ().add (explorerPane);</pre>
|
||
|
|
<strong>Examples</strong></div>
|
||
|
|
</div>
|
||
|
|
<div class="section"><p>This <a href="vjoblistexample.htm#vjoblistexample">VJobList
|
||
|
|
example</a> presents an AS400ExplorerPane filled with a list of jobs. The
|
||
|
|
list shows jobs on the system that have the same job name.</p>
|
||
|
|
</div>
|
||
|
|
<div class="section"><p>The following image shows the VJobList graphical user interface
|
||
|
|
component:</p>
|
||
|
|
</div>
|
||
|
|
<div class="section"><p><img src="rzahh089.gif" alt="VJobList graphical user interface component" /></p>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
|
||
|
|
</body>
|
||
|
|
</html>
|