All Packages  This Package  Class Hierarchy  Class Search  Index

Class bmsi.edx.EDX
java.lang.Object
   |
   +----bmsi.edx.EDX

  Summary

public class  EDX
     extends java.lang.Object
     implements bmsi.edx.Edxsys, 
                bmsi.edx.Edxtcb, 
                bmsi.edx.Edxprg
{
          // Fields 1
     public static final int MAXPART;

          // Constructors 2
     public EDX() throws EDXException;
     public EDX(String) throws EDXException;

          // Methods 29
     public ActiveTCB active(int, int);
     public void atoe(int, int, int, String);
     public final void attach(short, char, short) throws EDXException;
     public final void cancel(short, char, short) throws EDXException;
     public final void copyIn(int, int, byte[], int, int);
     public final void copyOut(int, int, byte[], int, int);
     public final void deq(short, char, short) throws EDXException;
     public void dispose();
     public String etoa(int, int, int);
     public final char getAddr(int, int);
     public final byte getByte(int, int);
     public final byte[] getBytes(int, int, int);
     public final int getDword(int, int);
     public int getNumpart();
     public MapEntry[] getPartitionMap(int);
     public final String getText(int, int);
     public String getVtab();
     public final short getWord(int, int);
     public final void pcheck(short, char, short) throws EDXException;
     public final void post(short, char, short) throws EDXException;
     public final void putByte(int, int, int);
     public final void putBytes(int, int, byte[]);
     public final void putDword(int, int, int);
     public final void putWord(int, int, int);
     public final void ready(int, int) throws EDXException;
     public synchronized void startinitial() throws EDXException;
     public final void tick() throws EDXException;
     public String toString();
     public PROG wheres(String);
}

A class to interface to a running EDX emulator.

Author:
Stuart D. Gathman Copyright (C) 1998 Business Management Systems, Inc.




  Fields

· MAXPART

Summary  |  Top

   public static final int MAXPART


  Constructors

· EDX

Summary  |  Top

   public EDX(String vtab)  throws EDXException

Create an interface to an EDX emulator. We can interface to multiple emulators distinguished by which edxvtab.sys file they are using.

Parameter Description
vtab The edxvtab.sys file that defines which emulator.



· EDX

Summary  |  Top
   public EDX()  throws EDXException

Create an interface to the default EDX emulator. It is defined by the edxvtab.sys file in the directory named by the bmsi.edxdir system property, /edx by default.



  Methods

· getNumpart

Summary  |  Top
   public int getNumpart() 

Return the number of partitions in the EDX emulator.



· getVtab

Summary  |  Top
   public String getVtab() 

Return the volume table file that defines this EDX VM.



· getByte

Summary  |  Top
   public final byte getByte(int key, 
                             int addr) 

Return the BYTE at an EDX address.



· putByte

Summary  |  Top
   public final void putByte(int key, 
                             int addr, 
                             int val) 

Set the BYTE at an EDX address.



· getWord

Summary  |  Top
   public final short getWord(int key, 
                              int addr) 

Return the WORD at an EDX address.



· getAddr

Summary  |  Top
   public final char getAddr(int key, 
                             int addr) 

Return the unsigned WORD at an EDX address.



· putWord

Summary  |  Top
   public final void putWord(int key, 
                             int addr, 
                             int val) 


· getDword

Summary  |  Top
   public final int getDword(int key, 
                             int addr) 

Return the DWORD at an EDX address.



· putDword

Summary  |  Top
   public final void putDword(int key, 
                              int addr, 
                              int val) 

Store a DWORD at an EDX address.



· etoa

Summary  |  Top
   public String etoa(int key, 
                      int addr, 
                      int len) 

Return an EBCDIC char field as a String. No blanks are stripped, you can call trim() if desired.



· atoe

Summary  |  Top
   public void atoe(int key, 
                    int addr, 
                    int len, 
                    String txt) 

Set an EBCDIC char field from a String. The String will be truncated or padded with blanks to fit in len EBCDIC bytes.



· getText

Summary  |  Top
   public final String getText(int key, 
                               int addr) 

Return an EDX TEXT object as a String. No blanks are stripped.



· getBytes

Summary  |  Top
   public final byte[] getBytes(int key, 
                                int addr, 
                                int len) 

Return a copy in a byte[] of a portion of EDX memory.



· putBytes

Summary  |  Top
   public final void putBytes(int key, 
                              int addr, 
                              byte[] b) 

Copy a byte[] into EDX memory.



· copyOut

Summary  |  Top
   public final void copyOut(int key, 
                             int addr, 
                             byte[] b, 
                             int off, 
                             int len) 

Copy EDX memory into a byte array.



· copyIn

Summary  |  Top
   public final void copyIn(int key, 
                            int addr, 
                            byte[] b, 
                            int off, 
                            int len) 

Copy part of a byte array into EDX memory.



· dispose

Summary  |  Top
   public void dispose() 

Release the resources used by this EDX interface. Subsequent uses will throw an exception.



· ready

Summary  |  Top
   public final void ready(int key, 
                           int tcb)  throws EDXException

Wakeup an EDX task.



· deq

Summary  |  Top
   public final void deq(short key, 
                         char qcb, 
                         short code)  throws EDXException

Deq an EDX QCB.



· post

Summary  |  Top
   public final void post(short key, 
                          char ecb, 
                          short c)  throws EDXException

Post an EDX event.



· attach

Summary  |  Top
   public final void attach(short k, 
                            char tcb, 
                            short c)  throws EDXException

Attach an EDX task.



· pcheck

Summary  |  Top
   public final void pcheck(short k, 
                            char a, 
                            short c)  throws EDXException

Cause a program check in a running EDX program.



· cancel

Summary  |  Top
   public final void cancel(short k, 
                            char a, 
                            short c)  throws EDXException

Cancel an EDX program. This has the same effect as if the EDX program were to execute PROGSTOP as the next intruction.

Parameter Description
k the address key of the program
a the address of the program
c the PROGSTOP code



· tick

Summary  |  Top
   public final void tick()  throws EDXException

Interrupt EDX execution so that the emulator can check timer queues, run a higher priority TASK, etc.



· startinitial

Summary  |  Top
   public synchronized void startinitial()  throws EDXException

Start $INITIAL in a newly loaded edxnuc. Does nothing if $INITIAL has already been run or the edxnuc is corrupted.



· active

Summary  |  Top
   public ActiveTCB active(int key, 
                           int tcb) 

Get an active TCB context. This determines the default partition as well for a short form of the get/put methods.

Parameter Description
key the address key of the tcb
tcb the tcb address or 0

Returns:
a TCB context


· getPartitionMap

Summary  |  Top
   public MapEntry[] getPartitionMap(int key) 

Return a snapshot of the memory map for an EDX partition.

Parameter Description
key the address key for the partition. Partition 1 is address key 0.

Returns:
an array of map entries for the partition, or null if the partition is not allocated.
Throws: ArrayIndexOutOfBoundsException
if the address key is not between 0 and getNumpart().


· wheres

Summary  |  Top
   public PROG wheres(String progname) 

Find a running EDX program.

Parameter Description
progname the name of the program

Returns:
the first program found with a matching name, or null if not found


· toString

Summary  |  Top
   public String toString() 
Overrides:
toString in class Object


All Packages  This Package  Class Hierarchy  Class Search  Index
Freshly brewed Java API Documentation automatically generated with polardoc Version 1.0.7